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PREFACE 


MANUAL OBJECTIVES 


The VAX-11/750 Software Installation Guide presents’ step-by-step 
procedures for installing software on a VAX-11/750 processor. 
VAX-11/750 software installation falls into three general categories: 


e Installing software on a newly purchased VAX/VMS system 
e Applying system maintenance updates to a VAX/VMS system 


e Upgrading an existing VAX/VMS system 


INTENDED AUDIENCE 


This manual is intended for those users who are responsible for 
managing and controlling the operating system. 


STRUCTURE OF THIS DOCUMENT 
This manual is divided into the following chapters and appendixes: 


e Chapter 1, Overview of Software Installation, briefly 
describes the process of bootstrapping and installing a 
VAX/VMS operating system and describes the VAX-11/750 console 
subsystem. 


e Chapter 2, Building a Bootable System Disk, describes’ the 
procedures for restoring the software distribution kit to a 
bootable format. 


e Chapter 3, Site-Specific Modifications to VAX/VMS, describes 
how to make modifications to VAX/VMS so that it more closely: 
fits your site's needs. 


e Chapter 4, The VMSINSTAL Command Procedure, describes how to 
use VMSINSTAL.COM to install system maintenance updates, 
optional software products, and EDTCAI. 


e Chapter 5, The System After Installation, describes different 
procedures that can be performed after installation. These 
include backing up the console TU58 cartridge, booting the 
system after installation, building and copying a VAX/VMS 
system disk, and building a stand-alone BACKUP kit. 


e Appendix A, Files of the VAX/VMS System, lists the 


DIGITAL-supplied directories on the system disk and their 
contents. 
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e Appendix B, Using the TU58 Tape Cartridge, describes in detail 
the steps to be taken when bootstrapping the system uSing the 
TU58 tape cartridge as the primary bootstrap device. 


e Appendix C, BOOTS8 Commands, describes the commands that can 
be entered to the stand-alone BOOT58 program. 


e Appendix D, Micro Verify Error Characters, describes micro 
verify routines that test the reliability of VAX-11/750 
hardware. 


e Appendix E, Installing Optional Software Products, describes 
the VMSUPDATE.COM command procedure used to install some 
optional software products. 


e Appendix F, Building the VAX/VMS Source Kit, describes’ the 
steps to be taken to copy the VAX/VMS source kit. 


e Appendix G, Upgrading the System, describes the steps required 
to upgrade a system from a Version 2.5 system to a 3.0 system. 


e Appendix H, VMSINSTAL Error Messages, describes the error 
messages issued by the VMSINSTAL command procedure. 


ASSOCIATED DOCUMENTS 


There are no prerequisites to using this document, but it is strongly 
recommended that you read the VAX/VMS Release Notes supplied with 
Versions 3.0, 3.1 and 3.2, for the most current information about 
VAX/VMS before installing software. 


In addition, an understanding of the information presented in _ the 
VAX/VMS Summary Description and Glossary and the VAX/VMS Command 
Language User's Guide may prove helpful. 
The following documents, which are referred to in this manual, provide 
the information needed to manage the day-to-day operation of the 
VAX/VMS system once it is initialized. 

@ VAX/VMS System Management and Operations Guide 

® VAX-11 Utilities Reference Manual 
For a complete list and description of VAX-l11l documents, including 
optional software product documents, see the VAX-11 Information 


Directory and Index. 


Further documentation on installing optional software products is 
included with each optional software product. 
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CONVENTIONS USED IN THIS DOCUMENT 


Convention 


$ SHOW TIME 


file-spec,... 


Meaning 


A symbol with a one- to three-character 
abbreviation indicates that you press a key on 
the terminal, for example, (ED. 


The phrase CTRL/x indicates that you must 
press the key labeled CTRL while you press 
another key, for example CTRL/C, CTRL/Y. 


Command examples show all output lines or 
prompting characters that the system prints or 
displays in black letters. All user-entered 
commands are shown in red letters. 


Horizontal ellipsis indicates that additional 


parameters, values, or information can be 
entered. 
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SUMMARY OF TECHNICAL CHANGES 


The following technical changes have been made to the VAX-11/750 
Software Installation Guide for Version 3.2: 


Chapter 4, The VMSINSTAL Command Procedure, has been rewritten 
to reflect significant changes and additions to the VMSINSTAL 
command procedure. 


The procedure for upgrading a Version 2.5 VAX/VMS system to a 
Version 3.0 VAX/VMS system has been moved to Appendix G. 


Appendix H, VMSINSTAL Error Messages, has been added to 
explain error messages issued by the VMSINSTAL command 
procedure. 


Installation information about RA60 disks has been added. 


Information about remastered distribution kits has been added. 
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CHAPTER 1 


OVERVIEW OF SOFTWARE INSTALLATION 


There are three general categories of VAX-11/750 software 
installation: 


e Bootstrapping and installing a newly purchased VAX/VMS system 
e Applying system maintenance updates to a VAX/VMS system 
@e Upgrading an existing VAX/VMS system 


Installation refers to setting up a VAX/VMS operating system on a new 
VAX-11/750 processor. Updating refers to applying system maintenance 
updates, and consists primarily of a set of patches distributed on 
TU58 cartridges. Upgrading refers to bringing a Version 2.5 system up 


to the next major version, Version 3.0, and is done substantially by 


aiaveaAeY 1 J Vives 


File replacement. 


All installation procedures are performed using the VAX-11/750 console 
subsystem. 


1.1 VAX-11/750 CONSOLE SUBSYSTEM 


The console subsystem consists of three hardware components (a console 
terminal, a TU58 cartridge drive, and an optional remote diagnostics 
port) and a microcode program. These hardware components and_ the 
microcode program perform the actual bootstrap operation based on: 
(1) the positions of the switches on the processor control panel, and 
(2) the interactive commands entered at the conSole terminal. 


You can request that the system be bootstrapped in either of the 
following ways: 


e Directiy from the system disk 
e Using the stand-alone BOOT58 program on the TU58 cartridge 


Both methods require the assistance of the console subsystem. The 
recommended approach for daily operation is from the system disk with 
the TU58 cartridge as backup. Using the first method, you issue a 
BOOT command to the console subsystem to bootstrap the system from a 
particular device. Using the second method, you issue a BOOT command 
to the console subsystem to bootstrap the stand-alone BOOT58 program. 
With stand-alone BOOT58, you can then bootstrap the system by 
specifying either stand-alone BOOT58 commands or a command procedure 
stored on the console TU58 cartridge. (See Appendix B for more 
information on the BOOT58 program.) 


Figure 1-1 shows a diagram of the basic console subsystem. 
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Figure 1-1: VAX-11/750 Console Subsystem 


1.2 VAX-11/750 PROCESSOR CONTROL PANEL 


The VAX-11/750 processor control panel consists of seven indicator 
lights, four switches, and the TU58 cartridge drive. These switches 
and indicator lights reflect the current state of the system and 
dictate how the system will react to initial bootstrapping, shutdowns, 
and restarts. Figure 1-2 shows a diagram of a VAX~-11/750 processor 
control panel. 


1.2.1 Indicator Lights 


There are seven indicator lights on the processor front panel: the 
first three indicate the state of the processor, and the remaining 
four indicate the state of the remote diagnostic procedures. 


CPU State Indicators 


POWER When lit, this green light indicates that the 
power is present in the processor and that the 
keyswitch is in the ON position. 


RUN When lit, this green light indicates that the 
processor is running. 


ERROR When dimly lit, this red light indicates’ the 
processor is running normally. When brightly lit, 
this red light indicates that the processor has 
experienced an unrecoverable error. Push the 
white INITIALIZE button to reset the machine. 
(The ERROR light will remain dimly lit.) During 
normal operation, if the light is not on at all, 
the bulb has burned out. 
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Figure 1-2: The VAX-11/750 Processor Controi Panel 


Remote Diagnostic Indicators 


The remote diagnostic indicator lights are invisible until they are 
lit on a machine that has a remote diagnostic ROM installed. 


REMOTE D When lit, this red light indicates that the 
keylock rotary switch is in the REMOTE position. 


RD FAULT When lit for more than ten seconds, this red light 
indicates that the remote diagnostic ROM has 
detected an error. When a machine that has a 
remote diagnostic ROM is powered up, this light 
will come on for about ten seconds, to indicate 
that a self test is in progress. 


RD TEST When lit, this green light indicates that the 
remote host connection has been made with 
successful protocol exchange. 


RD CARRIER When lit, this amber light indicates that a 
carrier signal is present on a dial-in line. 


1.2.2 POWER-ON-ACTION Switch 


The POWER-ON-ACTION switch controls the processor's power-up sequence. 
The processor interprets and acts on the position of the 
POWER-ON-ACTION switch in the following situations: 


e After an orderly shutdown 
e After a brief power failure 


e After the microcode detects a halt condition (for example, a 
HALT instruction executed in kernel mode) 


The POWER-ON-ACTION switch has four positions that instruct the 
processor how to power up the system. The instructions are: 


BOOT Bootstraps the system from the device selected by 
the BCOT DEVICE switch. 


RESTART/BOOT Restarts the system. If the restart. fails (if 
memory battery backup fails during a _ power 
failure, for example), bootstraps the system from 
the device selected by the BOOT DEVICE switch. 


HALT Halts the system and displays the console prompt 
(>>>) at the console terminal. 


RESTART/HALT Restarts the system. If the restart fails, halts 
the system. 
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During normal system operation, the POWER-ON-ACTION switch should be 
set to the RESTART/BOOT position. This switch setting provides for 
the most comprehensive system recovery procedure. 


1.2.3 BOOT DEVICE Switch 


The BOOT DEVICE switch can be used to select the system's bootstrap 
device. The processor interprets and acts on the position of the BOOT 
DEVICE switch in the following situations: 


e When you issue the console BOOT command without specifying a 
device name 


e When the system attempts an automatic bootstrap 


In both situations, the processor examines the BOOT DEVICE switch and 
assumes that the controller character is A and that the unit number of 
the drive is 0. 


The BOOT DEVICE switch has four positions: A, B, C, and D. Position 
A always causes the system to bootstrap from the TU58 cartridge drive. 
Positions B, C, and D correspond to the remaining disk controllers. 
Consult your local field service representative to determine how the 
positions correspond to the available disk controllers. Typically, 
you should set the BOOT DEVICE switch to the position corresponding to 
your system disk. 


1.2.4 INITIALIZE Button 


When you press the white INITIALIZE button, the system performs an 
automatic shutdown followed by a power-up sequence without disturbing 
the contents of memory. The system determines the power-up action by 
examining the position of the POWER-ON-ACTION switch. 


1.2.5 Keylock Rotary Switch 


The keylock rotary switch controls the actions of the processor. and 
the console subsystem. 


OFF Power is off. 


SECURE Processor can be-~ run; however, the console 
commands, remote diagnostic line, and INITIALIZE 
button are disabled. 


LOCAL Processor can respond to console commands, and the 
remote diagnostic line is disabled. 


REMOTE/SECURE Console commands and the INITIALIZE button are 
disabled, and the optional remote diagnostic line 
replaces the console terminal. 


REMOTE Console commands are disabled; however, they can 
be activated by means of the optional remote 
diagnostic line. 
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1.3. OVERVIEW OF SYSTEM INSTALLATION 


Installation can be performed by any system user who has access to the 
console terminal. 


To bootstrap and install a VAX/VMS operating system, perform the 
following steps at the console terminal: 


1. Restore the required save set (the files required for a 
bootable system) from the distribution kit to disk, using the 
Stand-alone version of the Backup Utility (BACKUP). 


2. Bootstrap the system. 


(When booting, additional files will be restored from _ the 
distribution kit. These files are referred to as the library 
and optional save sets.) 


3. Shut down the system and reboot. 
4. Run the User Environment Test Package (UETP). 


This installation process is restartable at any point. Steps one and 
two are described in Chapter 2, Building a Bootable System Disk. 
Steps three and four are described in Chapter 3, Site-Specific 
Modifications to VAX/VMS. 


The updating procedure is described in Chapter 4. The upgrading 
procedur 


CHAPTER 2 


BUILDING A BOOTABLE SYSTEM DISK 


The VAX-11/750 software distribution kit for the VAX/VMS' operating 
system contains the following: 


e The distribution tape, RKO7 disk, RA60 disk, or RLO2 disk(s) 


e Two TU58 cartridges containing stand-alone BACKUP (only with 
magnetic tape distribution kits; RKO7,  RA60, and RLO2 
distribution kits contain two blank TU58 cartridges to be used 
in creating a stand-alone BACKUP kit) 


e One blank TU58 cartridge to be used in creating a new console 
TU58 


The distribution tape or disks contains all the files needed to create 
a VAX/VMS operating system. However, aS they exist in the 
distribution kit, the VAX/VMS files are split into three groups called 
BACKUP save sets. The save sets are in a compressed format and do not 
comprise a usable system. The files in the save sets must be restored 
to another disk, using the stand-alone Backup Utility that is 
contained on the distribution disk (or on TU58 cartridge for magnetic 
tape distribution kits). The restoration process reformats the files 
into a usable VAX/VMS system. 


The three save sets are composed of different types of files. One 
save set contains all the files required for a bootable system; the 
others consist of the VAX/VMS library and VAX/VMS optional files. 


NOTE 


Only new installation sites using’ the 
VAX/VMS Version Seo remastered 
distribution kit should install their 
system using the instructions in this 
chapter. If you are already operating 
on a VAX/VMS Version 3 operating system, 
you must perform updates to your system 
using the instructions in Chapter 4 of 
this manual. If you are operating on a 
VAX/VMS Version 2.5 operating system or 
lower, see Appendix G. 


2.1 OVERVIEW OF BUILDING A BOOTABLE SYSTEM DISK 
There are four steps to building a bootable system disk: 


1. Stand-alone BACKUP is booted, either from the RKO7 disk for 
RKO7 distribution kits, from the RA60 disk for RA60 
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distribution kits, from the primary distribution disk for the 
RLO2 distribution kits, or from the TU58 cartridges for 
Magnetic tape distribution kits. 


2. Stand-alone BACKUP restores the required save set from _ the 
distribution kit to the target disk, creating a kernel 
VAX/VMS system. 


3. The kernel VAX/VMS system is booted. 

4. Once booted, the kernel VAX/VMS system restores the library 
and optional save sets from the distribution kit to the 
target disk. On RLO2/RA80 configurations the optional save 
set is distributed on a separate RLO2 disk and may be 
restored at a later date, if desired. 

Before you can build a bootable system disk, you must verify that you 
have received all needed VAX/VMS V3.2 software. You must also know 


how to specify device names and power up the system. Sections 2.2 
through 2.4 describe these procedures in detail. 


2.2 VAX/VMS SOFTWARE DISTRIBUTION KITS 


VAX/VMS software for the VAX-11/750 is distributed on either an  RKO7 
disk, an RA60 disk, two RLO2 disks, or on magnetic tape. 


The bill of materials that comes with the kit lists the entire 
contents of that kit. Check to make sure you have received everything 
listed. 

In addition to the materials contained in the software distribution 
kit, you will also need a console TU58 cartridge before you can 
proceed with an installation or upgrade. If you are a new customer, 
the console TU58 cartridge was shipped with the hardware. For other 


customers, your current console TU58 cartridge will be upgraded as 
part of the VAX/VMS upgrade procedure. 


2.2.1 Magnetic Tape Kit 


The VAX-11/750 magnetic tape software distribution kit contains’ the 
following: 


e The VAX/VMS Version 3.2 distribution tape 
Part number: BB-D782F-BE 
Part description: VAX/VMS V3.2 BIN 16MT9 
e Two TU58 cartridges that contain stand-alone BACKUP 
Part number: BE-M757A-BE 
Part description: V3.2 S/A BKUP T58 1/2 
Part number: BE-M758A-BE 


Part description: V3.2 S/A BKUP T58 2/2 
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e One blank TU58 cartridge to be used in creating a new console 
TU58 
Part number: 36-15809-00 


Part description: BLANK TU58 CASSETTE 


2.2.2 RKO7 Kit 
The VAX-11/750 RKO7 software distribution kit contains the following: 
e The RKO7 Version 3.2 distribution disk 
Part number: AY-HO20F-BE 
Part description: VAX/VMS V3.2 BIN RK7 
e Three blank TU58 cartridges: two to be used in creating a 


stand-alone BACKUP kit, one to be used in creating a new 
console TU58 


2.2.3 RA60 Kit 
The VAX-11/750 RA60 software distribution kit contains the following: 
e The RA60 Version 3.2 distribution disk 
Part number: BD-R379A-EE 
Part description: VAX/VMS V3.2 BIN RA6 
e Three blank TU58 cartridges: two to be used in creating a 


stand-alone BACKUP kit, one to be used in creating a new 
console TU58 


2.2.4 RLO2 Kit 


The VAX/VMS operating system on an RLO2/RA80 configuration is 
distributed on two separate RLO2 disks: 


e A primary distribution disk 
e An optional distribution disk 


The primary distribution disk contains the files needed to create a 
VAX/VMS operating system. 


It consists of two BACKUP save sets that are composed of different 
types of files. One save set contains all the files required for a 
bootable system, and the other consists of the VAX/VMS library files. 


The optional distribution disk contains additional pieces of the 
VAX/VMS operating system, including compatibility mode files, VAX-1l 
BLISS files, programming examples, and miscellaneous other files. The 
optional disk also contains the EDTCAI course, which is not part of 
the operating system. The optional distribution disk may be restored 
either at installation time or at a later date. 
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2.2.4.1 The Primary Software Distribution Disk - To restore both the 
files required for a bootable system and the VAX/VMS library files, 
you need the following: 
e The VAX/VMS Version 3.2 primary distribution disk 
Part number: BC-M761B-BE 
Part description: VAX/VMS V3.2 REQUIRED RL2 
e Three blank TU58 cartridges 


The three blank TU58 cartridges are provided for building stand-alone 
BACKUP and copying the console media. Procedures for both of these 
operations are described in Chapter 4. 


2.2.4.2 The Optional Software Distribution Disk - To restore the 
optional VAX/VMS files, you need the following: 


e The VAX/VMS Version 3.2 optional distribution disk 
Part number: BC-M762B-BE 


Part description: VAX/VMS V3.2 OPTIONAL RL2 


2.3 SPECIFYING DEVICE NAMES 


You will need to specify a device name twice in order to build a 
bootable system disk: once when specifying the location of the target 
disk for the required save set, and once when responding to the data 
prompt asking which device is holding the distribution kit. 


All hardware devices supported on a VAX/VMS system have a device type 
code. Examples of these codes are listed in Table 2-1. 


The device name identifies the physical device on which a file is 
stored. The device name contains three fields, in the format ddcu: 


e The device type (dd). For example, an RKO7 disk is DM and a 
TE16 magnetic tape is MT. 


e A controller designator (c). The controller designator 
identifies the hardware controller to which the device is 
attached. The first or only controller is always designated 
A. 


e The unit number (u). The unit number button on the = front 
panel of the disk drive uniquely identifies a particular 
device unit. 


Some examples of device names are: 


Name Device 

DMA2 RKO7 disk on controller A, unit 2 

DLA1 RLO2 disk on controller A, unit 1 

MTAO TE16 magnetic tape on controller A, unit 0 
DUA10O RA81 disk on UDA controller A, unit 10 
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Table 2-1: Device Type Codes 


Code Device Type 

cs Console Storage Device 

DB RPO5, RPO6 Disks 

DD TU58 Cartridge Tape 

DL RLO2 Cartridge Disk 

DM RKO6, RKO7 Cartridge Disks 

DR RMO3, RMOS, RM80, RPO7 Disks (See note below) 
DU RA60, RA80, RA81 Disks 

DY RX02 Floppy Diskette 

LP Line Printer on LPll 

MF TU78 Magnetic Tape 

MS TS11 Magnetic Tape 

MT TE16, TU45, TU77 Magnetic Tapes 
OP Operator's Console 

RT Remote Terminal 

out Interactive Terminal on DZ11 


NOTE: When booting any of these devices at the console program prompt 
(>>>), use the mnemonic DB. 


2.4 POWERING UP THE SYSTEM 


To power up the system, check the switches and panel indicators and 
see that you have the console prompt (>>>). 


2.4.1 Checking the Switches and Panel Indicators 


To power up the system, the following switches should be in the 
positions indicated: 


e The ON-OFF power switch on the console terminal: ON 


e The POWER-ON-ACTION switch on the processor control 
panel: HALT 


e The rotary key switch on the processor control panel: LOCAL 


Also, be sure the POWER control panel indicator is lit. 
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2.4.2 Checking for the Attention of the Console Program 


See that you have the attention of the console program by checking for 
the three-angle-bracket (>>>) prompt. If this prompt does not appear, 
perform the following steps: 


l. Make sure the POWER-ON-ACTION switch is in the HALT position. 
2. Make sure the rotary key is in the LOCAL position. 


3. If the power is already on, press CTRL/P to cause the console 
program to prompt with three angle brackets (>>>). 


2.5 RESTORING THE DISTRIBUTION KIT 


The first step in restoring the distribution kit is loading 
stand-alone BACKUP. When stand-alone BACKUP is loaded, use it to 
restore the required save set to the target disk. Once booted, the 
kernel VAX/VMS system that is created automatically restores the 
library and optional save sets to the target disk. 


If you receive any error messages during installation, refer to the 
VAX/VMS System Messages and Recovery Procedures Manual. 


2.5.1 Loading Stand-alone BACKUP 


Stand-alone BACKUP can be loaded from either the RKO7 disk (RKO7 
distribution kits), the RA60 disk (RA60 distribution kits), the 
Primary RLO2 disk (RLO2 distribution kits), or from the TU58 
cartridges (magnetic tape distribution kits). 


2.5.1.1 Loading Stand-alone BACKUP from Disk - The procedure for 
loading stand-alone BACKUP from a disk is as follows: 


1. Place the distribution disk in the appropriate drive. Sites 
using the RLO2 distribution kit must use the primary 
distribution disk in this step. Write protect the disk by 
Pressing the WRITE PROTECT button, and spin it up by pressing 
the RUN button or the LOAD button, depending on the drive you 
are uSing. 


2. At the console prompt, boot stand-alone BACKUP by typing a 
"B" with the appropriate device type. For example, the 
following boots an RKO7 disk: 

>>> B DMcu 
(where c is the controller letter and u is the unit number) 
Two percent signs (%%) will appear on the console terminal. 

3. After about 10 seconds, you will observe the _ following 

message and DIGITAL Command Language (DCL) prompt ($) on the 


console terminal 


VAX/VMS Version V3.2 <date hh:mm> 
$ 
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2.5.1.2 Loading Stand-alone BACKUP from TU58 Cartridge - If you have 
a magnetic tape distribution kit, you will be booting BACKUP from TU58& 
cartridge. The procedure for loading stand-alone BACKUP from TU58 
cartridges is as follows: 


1. Place the distribution tape on a magnetic tape drive. Press 
the LOAD button. When the tape has loaded, press the ONLINE 
button. 


2% Insert the BACKUP TU58 marked VAX/VMS V3.0 S/A BKUP T58 1/2. 
3. At the console prompt, type: 
>>> B DDAO 


4. When BACKUP has finished loading the first TU58, after 
approximately 15 minutes, you will receive this message: 


VAX/VMS Version V3.2 <date hh:mm> 


Please mount second stand-alone system diskette or 
cartridge and press RETURN. 


5. Remove the first stand-alone BACKUP TU58, replace it with the 
second stand-alone BACKUP TU58 marked VAX/VMS V3.0 S/A BKUP 
T58 2/2, and press RETURN. 


6. When BACKUP has completed loading, after approximately five 
minutes, the DCL prompt ($) will appear, and you are ready to 
continue, 












‘7. Leave the Second BACKUP TU58 in the drive until you have 
restored the required save set. \ 





2.5.2 Restoring the Required Save Set to the Target Device 


After stand-alone BACKUP has been loaded, the procedure for’ restoring 
the required save set to the target disk is the same for both magnetic 
tape and disk distribution kits. 


l. Place the target disk in the drive and spin up the disk by 
pressing the RUN button. In the case of the RLO2/RA80 
configuration the target device is a nonremovable disk and 
need only be spun up. 


2. At the dollar sign prompt, type the BACKUP command in _ the 
following form: 


BACKUP/VERIFY ddcu:REQUIRED/SAVE ddcu: 


It is important to type the exact syntax of the command, 
including all colons and spaces. 


For example, when your magnetic tape distribution kit is on 
drive MSAO: and your target disk is DMA1l:, you would type: 
dv 4d 
$ BACKUP/VERIFY MSA0:REQUIRED/SAVE DMA1: 


The /VERIFY qualifier specifies that the distribution medium 
and the target disk should be read and compared. Optionally, 
the /LOG qualifier can be used in addition to the /VERIFY 
qualifier, if you want BACKUP to list each file on the 
console terminal as it is restored. 
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You will then receive the following message: 
SBACKUP-I-STARTVERIFY, starting verification pass 


After a few minutes, you will receive the DCL prompt ($) at 
the console terminal. 


Halt the processor and terminate stand-alone BACKUP by 
pressing CTRL/P and then typing H. 


If you loaded stand-alone BACKUP from TU58 (magnetic tape 
distribution kit), remove the second BACKUP TU58 from the 
drive and replace it with the console TU58. 


NOTE 


The BACKUP command creates a system disk 
with a DIGITAL~provided set of volume 
parameters, including a cluster factor 
of 1. Most of these parameters, except 
for the cluster factor, can be modified 
after installation with the SET VOLUME 
command. To alter the cluster factor, 
however, you must back up the system 
disk, uSing the /NOINITIALIZE qualifier, 
to another volume that has been 
initialized with the desired values. 


2.6 BOOTING THE TARGET DEVICE AND RESTORING THE REST OF VMS 


To boot the partially built operating system and restore the rest of 


VAX/VMS, 


l. 


proceed as follows: 


At the console terminal, boot the target disk by typing’ the 
following: 


>>>B ddcu 
For example: 
>>> B DMAL 
The system will respond with the following message: 
VAX/VMS Version V3.2 <date hh:mm> 
SOPCOM, <date hh:mm:ss.s>, logfile initialized 
by operator OPAO 
logfile is SYSSMANAGER: OPERATOR. LOG 
Login quotas - Interactive limit=64, 
Current interactive value=0 


PLEASE ENTER DATE AND TIME (DD-MMM-YYYY HH:MM) 


Enter the date and time in the twenty-four hour clock format, 
and press RETURN. 


For example: If it is June 1, 1983, at 2:05 P.M., enter 
01-JUN-1983 14:05. 


The system will prompt you as follows: 


Enter drive holding distribution kit (DDCU): 
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Enter the name of the device holding the distribution kit. 


For example: 


MSAO 


The installation procedure uses this information to restore 
the library and optional save sets. 


In the case of the RLO2/RA80 configuration, the optional save 
set is distributed on a separate disk and may be installed 
either at installation time (described in Step 5), or at a 
later date (described in Section 2.6.1). 


The following messages will appear over the course of 
approximately 15 minutes, while the files are being restored. 


$M OUNT-I-MOUNTED, VMS032 mounted on <device> 


Restoring library save set. 
SBACKUP-I-STARTVERIFY, starting verification pass 


This step applies only to the RLO2/RA80 configurations. If 
you are installing any other configuration you should skip to 
Step 6. 


You will receive the following prompt. 


Do you wish to install the OPTIONAL distribution kit 
[No]? 


Press RETURN if you do not wish to install the optional kit. 
If you do not install the optional kit, the next message you 
will receive is the "Running AUTOGEN" message in Step 6. 
Continue the installation from that point. 


If you respond with the letter Y, you will receive the 
following prompt. 


Dismount the Primary distribution kit from drive DLAO. 
Mount the OPTIONAL distribution kit in drive DLAO, press return when ready. 


Spin down the primary disk and replace it with the optional 
disk. Spin up the optional disk and press RETURN. A 
confirmation of the disk mount will appear: 


MOUNT-I-MOUNTED, VMSOPT mounted on _DLAO: 
You will now receive the following messages: 


Restoring optional save set. 
tBACKUP-I-STARTVERIFY, starting verification pass 


Running AUTOGEN -- Please wait. 
While AUTOGEN is running, you will receive messages telling 


you which files have been created or extended. When it has 
completed running, you will receive the following message: 


%Opcom, <date hh:mm:ss.s>, message from user SYSTEM 
$SYSGEN-I-WRITECUR, CURRENT system parameters modified by process ID 
00010045 into file SYSSSYSROOT: [SYSEXE]SYS.EXE;1 


System shutting down to allow boot of complete V3.2 system. 
You must manually reboot the system after it halts. 
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While the system is shutting down, the command procedure 
displays shutdown messages. When the shutdown is complete, 
you receive the following message: 


SYSTEM SHUTDOWN COMPLETE - USE CONSOLE TO HALT SYSTEM 


7. Halt the system, by pressing CTRL/P, typing an "H", and 
pressing RETURN. 


8. Reboot the system by typing: 


>>> B ddcu 


Restoration of the distribution disk is complete; you have a_ running 
system. Refer to Chapter 3 for any site-specific modifications you 
might want to make to the system. 


2.6.1 Restoring the Optional Kit on an RLO2/RA80 Configuration 


Restoration of the save sets on the optional disk to the RLO2/RA80 
configuration can be done at a later date by invoking a command 
procedure (VMSINSTAL.COM) that uses the Backup Utility. The two save 
sets contained on the disk are restored separately; you can restore 
one without the other by specifying different parameters for the 
command procedure. 


To restore the optional kit to the system disk, perform the following 
procedure: 


1. Remove any disk currently in the RLO2 drive and replace it 
with the optional distribution disk. Write protect the disk 
by pressing the WRITE PROT button and spin up the disk. The 
unit number light will come on when the disk is ready. 


2. Log in as the system manager by performing the _ following 
steps at the console terminal: 


a. Press RETURN. 


b. In response to the system's request for your uSer name, 
type SYSTEM. 


c. In response to the system's request for your password, 
type the system manager password. 


The system returns the following message and DCL prompt: 


Welcome to VAX/VMS Version V3.2 
$ 


3. When the DCL prompt ($) appears on the console terminal, set 
your default directory to SYSSUPDATE by typing: 


$ SET DEFAULT SYSSUPDATE 


The system responds with another DCL prompt. 
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4. Type: 
S$ @VMSINSTAL VMSOPT 


This command invokes the VMSINSTAL command procedure, which 
prompts with: 


Enter drive holding distribution kit: 
5. Assuming that the RA80 drive is designated as unit 0 and the 
RLO2 drive is designated as unit 1, enter DLAl. The system 
responds with: 


$MOUNT-I-~MOUNTED, VMSOPT mounted on DLAI 


The command procedure then prompts: 


Enter the device to which the optional save-set should 
be restored (DDCU): 


6. When you enter DUAO, the system responds: 
Restoring optional files. 


After approximately 5 minutes, the following message appears 
on the terminal: 


SBACKUP-I-STARTVERIFY, starting verification pass 


After approximately 5 minutes more, you will receive the 
completion messages: 


OPTIONAL file set restoration complete. 
Kit installation complete. 


The optional VAX/VMS files are now restored to your system disk. You 
install the EDTCAI course from the optional disk by using the 
parameter EDTCAI in place of VMSOPT (See Chapter 4). 


CHAPTER 3 


SITE-SPECIFIC MODIFICATIONS TO VAX/VMS 


The VAX/VMS operating system that exists at this point in the 
installation procedure is already set for your site's hardware 
configuration. During initial bootstrap the AUTOGEN command procedure 
automatically set the system parameters, paging file, swapping file, 
system dump file, and installed images list to values’ considered 
appropriate for your system. On most systems no further modifications 
to these files should be required. 


Your site-specific start-up command procedure is blank and _ the 
bootstrap command procedure is a default. The procedures are set to 
these defaults to allow the initial bootstrap of the system and may 
require site-specific modifications. 
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e Modify system parameters for special hardware configuration 
needs or special workload requirements 


e Perform other site-specific modifications 


3.1 LOGGING IN TO THE SYSTEM 


Before you can perform any modifications to the system, you must log 
in as the system manager. Once the system is initialized, it 
announces itself with the following message: 


Login quotas - Interactive limit=64, Current interactive value=0 


SYSTEM Job terminated at <date hh:mm:ss.s> 


At this point, you can log into the system as the system manager by 
performing the following steps at the console terminal: 


le Press RETURN. 


2. In response to the system's request for your user name, type 
SYSTEM. 


3. In response to the system's request for your password, type 
MANAGER. 


The system displays the following message: 
Welcome to VAX/VMS Version V3.2 
and the Digital Command Language (DCL) issues its prompt (S$). When 


this prompt appears on the console terminal, you can begin modifying 
the system. 
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3.2 SITE-SPECIFIC MODIFICATIONS 


There are several site-specific modifications that may be performed 
while you are logged in as system manager. 


When the system is bootstrapped, it uses a default Start-up command 
procedure, SYSSSYSTEM:STARTUP.COM. This command procedure, in turn, 
requests the execution of a site-specific start-up command procedure, 
SYSSMANAGER:SYSTARTUP.COM, which is initially blank and should be 
customized for your site. For example, SYSTARTUP.COM could contain 
the commands that initialize and start up your site's batch and print 
queues. 


You may also want to customize the user authorization file and create 
user file directories. 


To perform these site-specific modifications, consult the VAX/VMS 
System Management and Operations Guide. 


3.3 SYSTEM SHUTDOWN AND REBOOT 


In order to ensure that all the modifications you perform are accepted 
by VAX/VMS, you must shut down and then_-reboot the system. 


1. Shut down the system by executing the following command 
procedure: 


S @SYSSSYSTEM: SHUTDOWN 


This command procedure prompts for the number of minutes 
until system shutdown, the reason for the shutdown, whether 
to spin down the disks, the expected time the system will be 
restored, and whether automatic reboot should be enabled. 


If you enabled automatic reboot, the POWER-ON-ACTION switch 
is already set to RESTART/BOOT; the BOOT DEVICE switch is 
already set to your current system disk, and the system 
handles rebooting by itself. You can skip steps 2 and 3. 


2. In response to the statement, "SYSTEM SHUTDOWN COMPLETE —- USE 
CONSOLE TO HALT SYSTEM," halt the processor by pressing 
CTRL/P to obtain the console prompt (>>>). 


3. To boot the system, make sure the BOOT DEVICE switch is set 
to boot from your newly built system disk, and type B. 


The system will respond with the message: 
VAX/VMS Version V3.2 <date hh:mm> 
The system is now completely installed. 


For more information on ways to boot the system, see Section 5.2. 
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3.4 MODIFYING SYSTEM PARAMETERS 


The AUTOGEN command procedure is automatically run upon initial 
bootstrap of your system. This procedure generates your VAX/VMS 
system with system parameter values suitable for your hardware. 
However in cases of unusual hardware configuration or special workload 
requirements, modifications of the system parameters may be necessary. 
The file SYSSSYSTEM:PARAMS.DAT contains the system parameters and can 
be edited to suit your needs. 


If you make changes or additions to the PARAMS.DAT file, when you are 
finished you must invoke the AUTOGEN command procedure with the 
command: 

$ @SYSSUPDATE:AUTOGEN 


Invoking AUTOGEN establishes your changes as the current values. 


For detailed information about system parameters refer to the VAX/VMS 
System Management and Operations Guide. 





3.5 VAX/VMS USER ENVIRONMENT TEST PACKAGE 


The first thing you should do with your newly installed system is- run 
the VAX/VMS User Environment Test Package (UETP). The UETP is a 
collection of tests designed to demonstrate that the hardware and 
software components of a VAX/VMS system are in working order. Details 
of running the UETP are described in the VAX/VMS UETP User's Guide. 
When the UETP runs to completion without encountering nonrecoverable 
errors, the system is ready for use. 





3.6 BACKING UP YOUR SYSTEM DISK TO A SCRATCH DISK OR TAPE 


To back up your system disk to a scratch disk or tape use stand-alone 
BACKUP TU58 cartridges. The procedure is as follows: 


1. Shut down your system. 


2. Write protect your system disk by pressing the WRITE PROTECT 
button. 


3. Boot stand-alone BACKUP from the TU58 cartridges (see Section 
Saves l)% 


4, Place a scratch volume on an appropriate drive. 
5. Issue one of the following BACKUP commands: 


For disk: BACKUP/VERIFY system-disk: scratch-disk: 
For tape: BACKUP/VERIFY system-disk: tape device:save-set name 


For example, where the system disk is DMAO and the~= scratch 
disk is DMAI: 


$ BACKUP/VERIFY DMAO: DMAI1: 


or more details on using BACKUP, see the BACKUP chapter of the VAX-11 
Utilities Reference Manual. 

If you received an RKO7 or RA60 distribution kit, see Section 5.4 to 
build stand-alone BACKUP on TU58 cartridges. 
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3.7 THE SYSTEM AFTER INSTALLATION 


Now that your system is installed, and any needed. site-specific 
modifications have been made, there are several procedures you may 
want to perform on the system. You can back up the console medium, 
perform several methods of boostrapping, build and copy a VAX/VMS 
system disk, or build a stand-alone BACKUP kit. See Chapter 5 for 
instructions on these procedures. 


CHAPTER 4 
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THE VMSINSTAL COMMAND PROCEDURE 


The command procedure VMSINSTAL is used to install system maintenance 
updates and optional software products. 


Eventually, all optional software products will be installed using 
VMSINSTAL. However, at the present time, VMSINSTAL is used to install 
only some optional software products. DIGITAL is in the process of 
converting the remaining optional software product installations to 
the use of VMSINSTAL. Until they have been converted, these optional 
software products will continue to be installed using the VMSUPDATE 
command procedure (See Appendix E). 


This chapter describes what to look for in the software product 
distribution kits, how to prepare for installation, how to invoke 
VMSINSTAL, how to choose among installation procedure options, and 
what to do in the event of a system failure during installation. This 
chapter does not describe the specific installation procedures for 
each update and product. The questions, prompts, and information that 
you receive during installation will differ from product to product. 
For specific installation details, consult the installation guide that 
comes with each update or _ product. This chapter also describes 
installation of EDTCAI, a software product that is included with some 
VAX/VMS distribution kits. 


For information explaining the error messages received from the 
VMSINSTAL command procedure, see Appendix H. 


4.1 EXAMINING THE DISTRIBUTION KITS 


System updates and optional software products are distributed on TU58 
cartridges or magnetic tape. EDTCAI is a save set on the VAX/VMS 
distribution kit, which can be either disk or magnetic tape. 


Each cartridge, disk, or tape is labeled with both a name and a serial 
number that differentiates it from others in the distribution kit. 
Check that your kit contains everything listed in the bill of 
materials. 


Included in each distribution kit is the installation guide specific 
to that update or product. 


4.2 PREPARING TO USE VMSINSTAL 


In order for VMSINSTAL to run pr 
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Back up your system disk (see Section 3.6). A system failure 
at acritical point of the installation could leave unusable 
files. In addition, optional software products may delete 
older product versions before installing new ones, so it is 
advisable to back up your system disk before attempting any 
software installation. The backup copy you create should be 
used for the installation to verify that the backup copy 
contains a working system and because, of the two, it has 
more free contiguous space, which you may need for 
installation. 


Log in at the console terminal under the system manager's 
account, SYSTEM. 


(If the SYSGEN parameters MOUNTMSG or DISMOUMSG at your site 
have been set to 1, you will receive a message from OPCOM 
each time a disk or tape is mounted or dismounted. These 
messages are normally disabled, but if they have been 
activated and you are installing from an operator's terminal, 
they will appear from one to thirty seconds after each mount 
or dismount.) 


Ensure that all users are logged out and that all batch jobs 
are completed. 


Prevent users from gaining access to the system by entering 
at the DCL prompt (S$): 


S$ SET LOGINS/INTERACTIVE=0 


Shut down DECnet-VAX (if your system includes it) by 
entering: 


S$ RUN SYSSSYSTEM:NCP 


The system responds with the NCP prompt (NCP>). At the 
prompt, enter: 


NCP> SET EXECUTOR STATE SHUT 


DECnet-VAX will perform an orderly shutdown and the OPCOM 
facility will notify you when DECnet-VAX is off. Exit from 
the NCP by typing EXIT at the prompt. 


Ensure that the limits in the SYSTEM account authorization 
record have values that are equal to or greater than the 
following designated default values: 


Buffered I/O byte count quota (BYTLM) = 20480 
Enqueue quota (ENQLM) = 20 

Buffered I/O limit (BIOLM) = 12 

Direct I/O limit (DIOLM) = 12 

Open file quota (FILLM) = 20 

AST limit (ASTLM) = 20 


To check these values, enter the following command at the DCL 
prompt: 


S$ SHOW PROCESS/QUOTA 


The system will display the current values of the SYSTEM 
account's authorization record. 


If necessary, you can change these values by entering at the 
DCL prompt: 
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S$ SET DEFAULT SYSSSYSTEM 
S$ RUN AUTHORIZE 


The system responds with the UAF prompt (UAF>). At the 
prompt, enter: 


MODIFY SYSTEM/limit=new-value 
For example: 
UAF> MODIFY SYSTEM/DIOLM=12 


To return to DCL command level, type EXIT at the UAF prompt. 
You must log out and log in again for any changes to take 
effect. 


NOTE 
Beyond this point in the installation 
procedures, installations vary according 
to update or product. The following 
section is a general description of how 
to invoke VMSINSTAL. Consult the 


specific update or product installation 
guide before invoking VMSINSTAL. 


4.3 INVOKING VMSINSTAL 

This section is a general description of how to invoke the VMSINSTAL 
command procedure. Section 4.4 describes options that may be used 
when invoking this procedure. 


To initiate installation using VMSINSTAL, enter the following command 
at the DCL prompt: 


@SYSSUPDATE:VMSINSTAL product-list ddcu: 
product—list 
A list of the product(s) being installed from the distribution 
volume. Items in a product list are separated by commas with no 
spaces and are of the format: 
facvvu 
In this format: 
fac is the facility name (1-6 alphanumeric characters). 
vv is the major version number (2 digits). 


u is the update number (1 digit). 


For example, the VAX/VMS operating system, version 3, update 
number 2 is: 


VMS032 


Items in this format allow you to install a specific version and 
update of a product from a distribution volume containing several 
versions and updates. If you specify only the facility name, 
with no version or update number, then all versions and updates 
present on the volume are installed in chronological order. You 
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may specify a wildcard character (*) for the product list, in 
which case all versions and updates of all products present on 
the volume are installed in chronological order. At the present 
time, DIGITAL generally distributes only a single version of a 
product per distribution volume, 


You will be prompted for a product list if you omit this 
parameter. 


ddcu: 


The device specification of the drive on which the distribution 
volume for the optional software product or maintenance update is 
to be mounted. You will be prompted for this parameter if you 
omit it. 


At this point, if the conditions described in Section 4.2 are not met, 
you will receive a warning that explains the problem and a prompt 
asking if you wish to continue. It is strongly recommended that you 
correct the situation before reinvoking VMSINSTAL. If you continue, 
the resulting installation may not be supported by DIGITAL. 


You will also be asked if you are satisfied with the backup of your 
system disk (see Section 4.2). Again, if you are not satisfied, it is 
strongly recommended that you correct the situation before continuing. 


Once you invoke VMSINSTAL you will receive several prompts’ and 
messages that direct and explain the installation. These prompts and 
messages differ depending on the update or software product. Consult 
the installation documentation that comes with the update or software 
product for specific instructions. If you need assistance during an 
installation, typing a question mark (?) at a prompt will give you an 
explanation of the acceptable responses to that prompt. 


At the end of an installation, VMSINSTAL will do one of two things, 
depending on the requirements of the update or product. It will 
either perform an automatic shutdown of the system and instruct you to 
manually reboot, or it will simply return you to the DCL command 
level. 


Finally, after installing the update or optional software product(s), 
you should back up the updated system disk. 


4.4 CHOOSING VMSINSTAL OPTIONS 


The VMSINSTAL command procedure permits the use of three options; 
Auto-answer, File Log, and Alternate Root. These options perform the 
following functions: 


Auto-answer 


Allows you to record the answers you give to queries and prompts 
during installation. When you install an update or product, you 
receive several prompts and queries to which you’ respond. When 
you use the Auto-answer option VMSINSTAL creates a file with the 
specification SYSSUPDATE:facvvu.ANS (if such a file does not 
already exist) and saves your responses in this file. I£ you 
reinstall a software product in the future (as you must when a 
major version of the VAX/VMS operating system is distributed) and 
you use the Auto-answer option, VMSINSTAL will check for the 
existence of facvvu.ANS and use the answers you have saved. If 
you reinstall without using the Auto-answer option, you will 
again receive prompts and queries during installation. 
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Note that if you wish to record new answers in a_ subSequent 
installation, you must first delete the existing answer file and 
then install the product again, specifying the Auto-answer 


option. 
File Log 


Logs all file activity to the terminal during installation. File 
activity is defined as any action that alters the disposition of 
a file, such as, creating a new file, updating a library, or 
deleting a file. 


Alternate Root 


Permits you to install to a system root other than that of the 
running system. The VAX/VMS system in the alternate root must be 
complete and at the same version/update level as the running 
system. All files and software products that are referenced by 
the product installation must be present in the alternate root. 


Note that not all optional software products allow installation to a 
system root other than that of the running system. Consult the 
specific product's installation documentation to determine whether it 
is possible. 


The format for invoking VMSINSTAL with these options is as follows: 


@SYSSUPDATE:VMSINSTAL product-list ddcu: OPTIONS option-list [root] 
OPTIONS 


A keyword that must be entered along with one or more options in 
the option list to guarantee against accidentally invoking an 
option. If you enter an option-list and the OPTIONS parameter is 
not entered, you will receive an error message and_ the 
installation will be terminated. 


option-list 
A list of the options requested. This list consists of one 
letter option abbreviations separated by commas, with no spaces. 
The abbreviations are: A for Auto-answer, L for File Log, and R 
for Alternate Root. You may specify any option or all three. 
However, if you specify Alternate Root, you must also specify the 
root parameter (see below). 


root 


The alternate system root to which you wish to install the 
product(s). It must be of the format: 


__ddcu: [SYSn.] 
(Note that two leading underscores are required.) 
In this format: 
ddcu is the device on which the alternate root resides 
[SY¥Sn.] is the top level directory of the alternate root 


You may specify a logical name that has been defined for an alternate 
root. 
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The following is an example, of using VMSINSTAL with options: 
$ @SYSSUPDATE: VMSINSTAL VMS032 CSAl: OPTIONS L,R __ DMA1:[SYSO.] 


In this example, update version 3.2 of the VAX/VMS operating system is 
being installed to the alternate root, [SYS0.], on the device, DMAI1. 
The file activity during installation is being logged to the terminal, 
as well. 


4.5 RECOVERING FROM SYSTEM FAILURE 


If you experience a system failure, such as power loss, during 
installation of an update or optional software product, VMSINSTAL will 
attempt to automatically continue the installation upon rebooting. If 
you are booting from the console TU58, you will have to place the 
console TU58 back in the console TU58 drive in order to reboot. 
Depending on the point in the installation at which the system failed, 
one of three conditions will exist: 


1. The system disk will not have undergone any changes’ before 
system failure. In this case, VMSINSTAL will instruct you to 
restart the installation. 


2. The system disk or a library used by the installation will 
have been corrupted. In this case, VMSINSTAL instructs you 
to restore either the system disk, or the corrupted library 
from the backup copy (see Section 4.2), and restart the 
installation. 


3. VMSINSTAL will continue the installation. In this case, 
VMSINSTAL performs most of the installation and then informs 
you that you must manually purge replaced files, even if you 
requested that they be purged automatically. If VMSINSTAL 
instructs you to do so, reboot the system, log in as _ system 
manager, and purge all system files by entering at the DCL 
prompt (S$): 


S$ PURGE/LOG SYSSSYSROOT: [*...]*.* 


When you have’ performed these tasks, installation is 
complete. 


4.6 INSTALLING EDTCAI 
The installation of EDTCAI uses neither VMSINSTAL as it is described 
above nor VMSUPDATE. It uses a version of VMSINSTAL without options 
that does not attempt to recover from a system failure. To install 
the EDTCAI course, perform all the steps described in Section 4.2, 
then proceed as follows: 

1. Mount your distribution disk or tape. 


2. Type the following command to initiate the installation of 
EDTCAI: 


$ @SYSSUPDATE:VMSINSTAL EDTCAI 
3. You will receive the following request: 


Enter drive holding distribution kit: 
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You must type your response in the format ddcu: dd is the 
device code; c, the controller letter, and iu, the unit 
number. 


You will then see the following message text at the terminal: 
This procedure will install the EDTCAI course on your system. 
This course will work on either the VT52 or a VT100 compatible 
terminal. However, the display library for each terminal type 
is over 500 blocks, and if you do not have a particular terminal 
type on your system, you might wish to save disk space by not 
installing that particular library. 

You will receive the following query: 
Do you wish to install the display library for VT52 terminals?: 

Respond YES or NO. 

You will then receive the next question: 


Do you wish to install the display library for VT100 terminals?: 


Answer YES or NO. You must install at least one of the two library 
files for the EDTCAI course to run on your system. 


After answering YES to at least one of the two preceding questions, 
you receive this message: 


Added course EDT, the EDTCAI Primer 


If you have upgraded from a previous version of EDTCAI, at this’ point 
you will be asked: 


Do you wish to copy student records from EDTCAI Vl to this 
version?: 


Answer YES or NO. If you answer YES, the names of the students will 
be displayed as they are copied. When all the names have been copied, 
the following will be displayed: 


Now that the student records are copied, you may delete the old 
records to save disk space. 


Do you wish to delete the old student records (Y or N): 

Answer YES or NO. If you answer YES, the following will be displayed: 
The old student records have been deleted. 

If you answer NO, the following will be displayed: 
The old student records have not been deleted. 


When the installation of the EDTCAI course is completed, you will 
receive this message: , 


Kit installation complete. 


CHAPTER 5 
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You will want to perform several operations after your system is 
installed: 


e Backing up the console TU58 cartridge 
e Performing several methods of bootstrapping 
e Building and copying a system disk. 


e Building a stand-alone BACKUP kit. 


5.1 BACKING UP THE CONSOLE MEDIUM 

It is important that you have a backup copy of the console medium. To 
back up the console medium, use the command procedure CONSCOPY 
contained in the SYSSUPDATE directory. CONSCOPY copies files from the 
TU58 cartridge to an empty scratch directory on a disk. From the 
scratch directory, the files can be restored to another TU58 
cartridge. (The blank TU58 cartridge included in your distribution 
kit may be used for this purpose if it was not used during the upgrade 
procedure.) To use CONSCOPY, proceed as follows: 

1. Log in under the system manager's account, SYSTEM. 


2. Create a scratch directory if one is not already available. 
If a directory already exists, make sure it contains no 
files. To create a directory, type: 

CREATE/DIRECTORY ddcu: [directory name] 
For example: 
$ CREATE/DIRECTORY DMA1: [WRK.CNSL] 
3. At the DCL prompt ($), enter the following: 
S$ @SYSSUPDATE:CONSCOPY 
4. You will receive the following question: 


Which kit do you want to build (780!750!730): 


Answer by typing 750. 
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A brief description of the SAVE and RESTORE operations will 
appear. 


You will then be asked whether you want to SAVE or RESTORE 
your console medium. 


Answer by typing SAVE. 
The following will then appear: 
Enter Files-11 device and directory (DDCU:[DIR]): 


Type in the device code for the disk to be copied to and 
specify the empty directory to contain the files. 


For example: 
DMA1: [WRK.CNSL] 

At this point, you will receive the following prompt: 
Enter the console device drive (DDCU:): 

Answer by typing CSAI1:. 


Put your console TU58 into the drive on the processor control 
panel and press RETURN when ready. 


When the files have been copied from the TU58 to the disk, 
you will receive this message: 


SAVE of your console medium is complete. 


Restoring Files to TUS58 Cartridge 


To restore files to another TU58 cartridge, proceed as follows: 


nee 


Invoke CONSCOPY by typing: 

S$ @SYSSUPDATE:CONSCOPY 
You will receive the following question: 

Which kit do you want to build (780!750!730): 
Answer by typing 750. 


A brief description of the SAVE and RESTORE operations will 
appear. 


You will then be asked whether you want to SAVE or RESTORE 
your console medium. 


Answer by typing RESTORE. 
The following will then appear: 
Enter Files-11l device and directory (DDCU: [DIR]): 


Type in the device code for the disk and_ specif the 
directory that contains the files. 
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5. At this point, you will receive the following prompt: 
Enter the console device drive (DDCU:): 
Answer by typing CSAI1:. 


6. Put the scratch TU58 into drive CSAl and press RETURN when 
ready. 


7. When the files have been restored from the disk to the TU58, 
you will receive this message: 


RESTORE of your console medium is complete. 


This newly created TU58 will be your console TU58. Keep the original 
as a backup copy. Press RETURN to mount this new TU58. 


5.1.2 Reading Command Procedures From Console Media 


To read bootstrap command procedures from the console TU58, you must 
first copy the files from the console TU58, using the DXCOPY command 
procedure in the directory [SYSUPD]. To use DXCOPY.COM for this 
purpose, proceed as follows: 


1. Invoke the command procedure by typing: 


Ss 


SYSSUPDATE: DXC OPY 


> 


$ 


2. The command procedure asks whether the console TU58 is 
mounted: 


Is the system console storage medium mounted (Y/N) ?: 


Place the console TU58 in the CSAl drive, type NO, and _ press 
RETURN, as prompted. 


3. The command procedure then asks whether the copy operation is 
from the console TU58: 


Copy from console medium (Y/N)?: 
Type YES to indicate a copy from the console TU58 to the 
default directory. 


4. Finally, the command procedure requests the name of the file 
to be copied from the console TU58. Type the name of the 
file and press RETURN. 


You can now read the file from the default directory. 


5.2 BOOTING THE SYSTEM AFTER INSTALLATION 


During installation, a default bootstrap is used for simplicity's 
sake. However, once the system has been installed, you can bootstrap 
the system in either of the following ways: 


e Conversational - Request that SYSBOOT stop and allow you _ to 
modify the system parameters that configure the system. 
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e Nonstop - Allow SYSBOOT to run to completion without your 
intervention. 


Whether you perform a conversational bootstrap or a nonstop bootstrap, 
the following options are available to you: 


e Bootstrap the system directly from the system disk 


e Bootstrap the system using the stand-alone BOOT58 program on 
the console TU58 cartridge 


5.2.1 Rebooting Stopping in SYSBOOT 


The system bootstrap program, SYSBOOT.EXE, is the secondary bootstrap 
program that loads and configures the system. Because you can request 
that SYSBOOT prompt for commands during the bootstrap operation, this 
procedure is known aS a conversational bootstrap operation. Using 
this procedure, you can do the following: 


e Designate the name of the file that contains system parameter 
values 


e Set and show individual parameter values 
e Specify an alternate site-independent start-up procedure 


To halt the processor and reboot stopping in SYSBOOT: 


1. Shut down the system by executing the following command 
procedure: 


S @SYSSSYSTEM: SHUTDOWN 


This command procedure prompts for the number of minutes 
until system shutdown, the reason for the shutdown, whether 
to spin down the disks, the expected time when the system 
will be restored, and whether automatic reboot should be 
enabled. 


2. In response to the statement, "SYSTEM SHUTDOWN COMPLETE - USE 
CONSOLE TO HALT SYSTEM," halt the processor and obtain the 
console prompt (>>>) by pressing CTRL/P. 


3. Bootstrap the system, using the following command: 
>>> B/1l ddcu 


(dd is the device type, c is the controller designator, and u 
is the unit number.) 


4. When SYSBOOT is ready to accept commands, it prompts as 
follows: 


$B 
SYSBOOT> 


The two percent signs (%$%) that precede the SYSBOOT prompt 
indicate a successful micro verify check. If the percent 
Signs do not appear, discontinue the bootstrap operation and 
contact your field service representative. 


When SYSBOOT prompts, you may uSe any of the subset of SYSGEN 
commands listed in Table 5-1 to examine or modify the system. 
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The following is an example of the SYSBOOT program: 
SYSBOOT> USE CURRENT 


SYSBOOT> SET WSMAX 512 
SYSBOOT> CONTINUE 


In this example, the program is told to use the current parameter file 
as a source for values, WSMAX is set to 512, and the bootstrap 
operation is continued. When VAX/VMS announces itself, the new 
parameter value you have designated is in use. More information about 
these SYSGEN commands can be found in the VAX-1l1 Utilities Reference 
Manual. 


Table 5-1: SYSBOOT Commands 





Command Description 
CONTINUE Resumes the bootstrap procedure 
DISABLE CHECKS Inhibits checking of parameter values 


specified with the SET command 


ENABLE CHECKS Permits checking 


specified with the 


of parameter values 
SET comman d 
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HELP Displays a summary of the SYSBOOT commands 
at your terminal 


SET parameter value Establishes’ the value of a system 
generation parameter 


SET/STARTUP procedure Specifies the start-up command procedure 
to be executed after SYSBOOT 


SHOW Displays specific parameters 


USE Specifies the parameter file to be used as 
a source of values (if a parameter file is 
specified, you must specify the entire 
file specification) 


5.2.2 Nonstop Bootstrap from the System Disk 


To perform a bootstrap operation from the system disk, without 
stopping in SYSBOOT, proceed as follows: 


1. Shut down the system by executing the following command 
procedure: 


$ @SYSSSYSTEM: SHUTDOWN 


2. In response to the statement, "SYSTEM SHUTDOWN COMPLETE - USE 
CONSOLE TO HALT SYSTEM," halt the processor by pressing 
CTRL/P to obtain the console prompt (>>>), and type the HALT 
command. 
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3. Type the console BOOT command in the following command 
format: 


>>> B ddcu 


(dd is the device type, c is the controller designator, and u 
is the unit number.) 


5.2.3 Rebooting Using the Default Bootstrap 


Under normal system operation, you do not need to interrupt’ the 
bootstrapping of the system to type commands to SYSBOOT; parameter 
values have already been established. To reboot using the default 
bootstrap, proceed as follows: 


1. Shut down the system by executing the following command 
procedure: 


S @SYSSSYSTEM: SHUTDOWN 


2. In response to the statement, "SYSTEM SHUTDOWN COMPLETE - USE 
CONSOLE TO HALT SYSTEM," halt the processor by pressing 
CTRL/P to obtain the console prompt (>>>), and type the HALT 
command. 


3. Either type BOOT or press the BOOT push button on the 


processor control panel. The processor will attempt to boot 
from the device selected by the Boot Device Switch on _ the 
front panel. 


Appendix B contains a description of bootstrapping from the console 
TU58. 


5.3 BUILDING AND COPYING A VAX/VMS SYSTEM DISK 


Occasionally, you may want to build or make a copy of your’ system 
software. VAX/VMS provides a command procedure named VMSKITBLD.COM as 
part of the system software for the purposes of building and copying a 
VAX/VMS operating system. 


NOTE 


Do not press CTRL/C or CTRL/Y while 


running VMSKITBLD.COM unless- you want 
the command procedure to terminate. 


5.3.1 Building a VAX/VMS System Disk 


You can use VMSKITBLD.COM to build a VAX/VMS system binary disk. For 
example, if you have a mixed-disk system (with RKO7 and either RPO6, 
RPO7, RMO3, RMO5, RA60, RA80, or RA81 disks, but no magnetic’ tape 
drives), you can use VMSKITBLD.COM to transfer your VAX/VMS system 
from an RKO7 disk cartridge to a larger, faster RP0N6, RPO7, RMO3, 
RMO5, RA60, RA80, or RA81 disk. 


Before you can use VMSKITBLD.COM to build a VAX/VMS system (on an 
RPO6, for example) you must boot your system, as described at the 
beginning of this chapter. With this RKO7 system running, proceed as 
follows: 
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1. Log in under the system manager's account. 
2. Establish the following default directory: 
S$ SET DEFAULT SYSSUPDATE 


3. Place either an RP06, RPO7, RMO3, RMO5, RA6O, RA80, or  RA81 
disk on an appropriate drive and place it online. This will 
be the target disk in the system building procedure. 


4. Type the following command to initiate the building of the 
system: 


S$ @VMSKITBLD 


5. Supply the needed information about the source and target 
disks as prompted. 


You then receive the following query: 
Is this a BUILD, ADD, or COPY operation?: 


Answer by typing BUILD. 


NOTE 


The BUILD option de 
SnfA ema tian ~ thar 
inrormation on cne 


builds the system. 


Continuation of the system disk-building procedure is indicated by the 
display of messages at your terminal. These messages either (1) 
prompt you for information needed to complete the copy operation, or 
(2) inform you of the current status of the building procedure. Each 
response should be followed by pressing the RETURN key. 


For example: 


Enter mounted source disk name (DDCU:): SYSSSYSDEVICE: 

Enter SOURCE disk top level system directory [default = SYSO]: 

Enter target disk name (DDCU:): DRAO: 

Enter the target disk's label [default = VAXVMSRL3]: 

Enter TARGET disk top level system directory [default = SYSO]: 
It will be necessary to initialize the target disks(s). 

Is the target disk, DRAO:, ready to be initialized? (Y/N): Y 
DRAO: allocated 

%MOUNT-I-MOUNTED, VAXVMSRL3 mounted on _DRAO: 

Create directory entries on the target disk. 

Copy the system executive files. 

Copy the system library files. 

Copy the system message files. 

Copy the system manager files. 

Copy the system update command files. 

Copy the system EXE files. 

Copy the system help files. 

Write a bootblock. 

Copy BLISS require files. 

Copy coding examples. 

Copy the EDTCAI files. 

Copy the UETP files. 
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VMSKITBLD.COM informs you when the system disk is built by sending the 
following message to your terminal: 


Kit is complete. 


At this point, the disk contains all the required VAX/VMS files for a 
complete system. The system can be properly configured by 
bootstrapping using the default parameters and then using the AUTOGEN 
procedure to configure the target system. 


To boot the system with the default parameters invoke the GEN version 
of the boot command file by typing: 


>>> B/1 ddcu 


When you have the SYSBOOT prompt (SYSBOOT>) type the following: 


SYSBOOT> USE DEFAULT 
SYSBOOT> CONTINUE 


The system will boot at this point. You can then log in as_ system 
manager and run the AUTOGEN procedure described in Chapter 12 of the 
VAX/VMS System Management and Operations Guide. 


5.3.2 Copying a VAX/VMS System Disk 


You can also use VMSKITBLD.COM to copy the files of the VAX/VMS system 
disk to a target disk that already contains a valid VAX/VMS system. 
The copy operation modifies only system files; it leaves all user 
files intact. 


Before you can use VMSKITBLD.COM to copy one system disk to another, 
your VAX/VMS system must be running and the source disk that you 
intend to copy must be mounted. Often, this source disk is the system 


disk from which the system was booted. Proceed as follows to copy the 
source disk to a target disk: 


1. Log in under the system manager's account (initially, the 
account with the user name SYSTEM and the password MANAGER). 


2. Establish the following default directory: 
$ SET DEFAULT SYSSUPDATE 
3. Place the target disk on an appropriate drive. 
4. Type the following command to initiate the copy operation: 


S$ @VMSKITBLD 


5. Supply the information needed about the source and target 
disks as prompted. 


You then receive the following query: 

Is this a BUILD, ADD, or COPY operation? 
Answer by typing COPY. 
Continuation of the copy operation is indicated by the display of 
messages at your terminal. These messages either (1) prompt you for 
information needed to complete the copy operation, or (2) inform you 


of the current status of the copy operation (see the example in 
Section. 5.33.1) % 
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VMSKITBLD.COM informs you when the copy operation is complete by 
sending the following message to your terminal: 


Kit is complete. 


At this point, the disk is ready to be bootstrapped. 


5.4 BUILDING A STAND-ALONE BACKUP KIT 


If you received your distribution kit on RKO7 or RA60 disk, the 
Stand-alone Backup Utility is contained on that disk. In order to 
have a kit for stand-alone operations, you must copy stand-alone 
BACKUP from the disk to TU58 cartridges. To create a stand-alone 
BACKUP kit, proceed as follows: 


1. Log in under the system manager's account, SYSTEM. 

2. At the DCL prompt ($), enter the following: 
@SYSSUPDATE:STABACKIT 

3. You will receive this request: 
Specify target device (DDCU:): 

Respond by typing the device name of the console drive: 

CSAI: 

4. The following message will appear: 


Please place the first TU58 in drive CSAlI1:. 
Press return when ready to continue: 


5. After you have placed the TU58 in the drive and_ pressed 
RETURN, you will receive these messages: 


SMOUNT-I-MOUNTED, STABACKUPA mounted on CSAI1: 
%CREATE-I-CREATED, CSA1: [SYSEXE] created 


If you are working at a console terminal, or if your terminal 
is enabled as an operator's terminal, you will also receive 
the following messages: 


SOPCOM, (DD-MMM-YYYY HH:MM:SS), message from user SYSTEM 
$SYSGEN-I-WRITECUR, CURRENT system parameters 

modified by process ID <ID number> into 

file SYSSSYSROOT: [SYSUPD]SYS.EXE;1 


These messages will be followed with a list of the files 
copied. When you have received the complete list of the 
files copied, the following message will appear: 


Please place the second TU58 in drive CSAl1:. 
Press return when ready to continue: 


6. After you have placed the second TU58 in the drive and 
pressed RETURN, you will receive these messages: 


%MOUNT-I-MOUNTED, STABACKUPB mounted on CSAI1: 
%CREATE-I-CREATED, CSA1: [SYSEXE] created 
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They will be followed with a list of the files copied. Then 
you will receive the following message: 
Kit is complete. 
Please replace the console medium. 
Press return when ready to continue. 


Replace the console TU58 and press RETURN. 


At this point, you have completed building a stand-alone 
BACKUP kit. 


APPENDIX A 


FILES OF THE VAX/VMS SYSTEM 


This appendix contains the names and brief descriptions of the files 
provided by DIGITAL on the VAX/VMS system distribution medium. The 
files on this medium are cataloged in ten directories. The names of 
the directories and descriptions of their contents follow. 


1a {SYSCBT] 
This directory is reserved for EDTCAI files. 
Za {SYSERR]} 


This directory is reserved for the error log file 
(ERRLOG.SYS). 


3. [SYSEXE] 


As shown in Table A-l, this directory contains commonly used 
executable images of the VAX/VMS operating system. 


4. [{SYSHLP] 


As shown in Table A-2, this directory contains text libraries 
for the HELP utility and other components. 


Table A-8 lists the contents of the subdirectory, 
[SYSHLP. EXAMPLES]. This subdirectory contains sample driver 
programs, user-written system service programs, and other 
source code examples of interest. 


5. [SYSLIB] 


As shown in Table A-3, this directory contains various macro 
and object libraries as well as other files used for general 
reference, 


6. [SYSMAINT] 


This directory is reserved for system hardware diagnostic 
programs. 


Te {[SYSMGR] 
As shown in Table A-4, this directory contains files used in 
managing the operating system. This directory is the default 
directory for the system manager's account. 


8. [SYSMSG] 


As shown in Table A-5, this directory contains system message 
text files. 


ws [SYS TEST | 
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As shown in Table A-6, this directory contains files used _ to 
run the User Environment Test Package (UETP). 


10. [SYSUPD] 


As shown in Table A-7, this directory contains files used in 
applying system updates. 


Table A-1: 


File Name 


ACC. EXE 
ANALYZOBJ.EXE 
ANALYZRMS. EXE 
AUTHORIZE. EXE 
AUTOGEN. PAR 
BACKTRANS. EXE 
BACKUP. EXE 
BAD. EXE 
BADBLOCK. EXE 
BCK. EXE 
BOOTS58. EXE 
BOOTBLOCK. EXE 
CANCEL. EXE 
CHECKS UM.EXE 
CHKSUM.CLD 
CLEDITOR. EXE 
CNDRIVER. EXE 
CNV. EXE 
CNVACC. EXE 
CONFIG. DAT 
CONINTERR. EXE 
CONVERT. EXE 
COPY.EXE 
CRDRIVER. EXE 
CREATE. EXE 
CREATEFDL. EXE 
CRF. EXE 
DBDRIVER. EXE 
DCL.EXE 
DCLDEF.STB 
DDDRIVER. EXE 
DEF. EXE 
DELETE. EXE 
DFN. EXE 
DIFF.EXE 
DIRECTORY. EXE 
DISKQUOTA. EXE 
DISMOUNT. EXE 
DLDRIVER. EXE 
DMDRIVER. EXE 
DMP. EXE 
DODRIVER. EXE 
DRDRIVER. EXE 
DSC1. EXE 


Files Contained in Directory [SYSEXE] 


Description 


Accounting Utility 

ANALYZE/IMAGE and ANALYZE/OBJECT image 
ANALYZE/RMS FILE image 

User authorization program 

Parameter file for the Autogen command procedure 
Back translator of DCL into MCR commands 
Backup Utility 

Bad Block Locator Utility 

Dynamic bad block Files-11l ACP subprocess 
RMS-11 backup utility 

Reserved for future use 

Reserved for future use 

CANCEL command 

Used during installation of VAX/VMS updates 
Used during installation of VAX/VMS updates 

Command Definition Utility 

DECnet CI datalink driver 

RMS-11 file conversion utility 

Convert V3.0 account file to V2.0 format 
Data file for configuration 

Connect-to-Interrupt driver 

Convert Utility 

File copy utility 

Card reader driver 

File and directory creation utility 

CREATE/FDL image 

Compatibility mode cross-reference utility 
RPO5 and RPO6 disk driver 

Command interpreter 

Global definitions for DCL structures 

TU58 driver 

RMS-11 interactive file definition utility 
File deletion/purge utility 

RMS-11 noninteractive file definition utility 
File compare utility 

Directory utility 

Disk Quota Utility 

Volume dismount utility 

RLO2 disk driver 

RKO7 disk driver 

RSX-11 File dump utility 

RB730 driver 

RMO3 disk driver 

Files-11l Structure Level 1 disk save and 
compress utility 


(continued on next page) 


Table A-1l (Cont.): 


File Name 


DSC2.EXE 


DSP. EXE 
DTR.COM 
DTRECV. EXE 
DTSEND. EXE 
DUDRIVER. EXE 
DUMP. EXE 
DXDRIVER.EXE 
DYDRIVER.EXE 
DZDRIVER. EXE 
EDF . EXE 
EDI.EXE 

EDT. EXE 
ERRFMT,. EXE 
EVL.EXE 
EVL.COM 
FLIAACP. EXE 


F11BACP.EXE 


FAL. COM 
FAL. EXE 
FLX, EXE 
HEXZAP. EXEL 
HLD. COM 
HLD. EXE 
IFL. EXE 
IMGDEF.STB 


INILOA. EXE 
INIT. EXE 
INPSMB. EXE 
INSTALL. EXE 
JBCSYSQUE. EXE 
JOBCTL. EXE 
LADRIVER. EXE 
LALOAD. EXE 


LALOADER. EXE 


LBR. EXE 
LCDRIVER. EXE 
LIBRARIAN. EXE 
LINK. EXE 
LOGINOUT. EXE 
LPDRIVER. EXE 
MAC. EXE 
MACRO32. EXE 
MAIL. EXE 
MATL. COM 
MAILEDIT.COM 


MBXDRIVER. EXE © 


MCR. EXE 


FILES OF THE VAX/VMS SYSTEM 


Files Contained in Directory [SYSEXE] 
Description 


Files-11l Structure Level 2 disk save and 
compress utility 

RMS-11 file attribute display utility 
DTRECV.EXE server initiating procedure 
DTSEND server 

DECnet logical links test program 

UDA disk driver 

DUMP utility 

RX01 console floppy diskette driver 

RX02 floppy diskette driver 

DZ11 port driver 

File definition language editor 

RSX-11M text editor 

EDT text editor 

Error logging facility 

DECnet event logging program 

Command file used by DECnet error logging 
Files-1l Structure Level 1 ancillary 
control process 

Files-1l1 Structure Level 2 ancillary 
control process 

FAL start-up procedure 


DESHnat Fila i 
DECnet file access li 


File Transfer Utility 

Hexadecimal image patching utility 

Command procedure used by HLD.EXE 

Down line task loading program 

RMS-11 utility index load program 

Global definitions for image activator 
structures 

System initialization program 

Disk device initialization utility 

Card reader input symbiont 

Utility that installs known images 
Queuing facility 

Job controller/symbiont manager 

LPA-11 driver 

Accepts commands from or sends requests to 
LALOADER to load LPA-11l microcode 
Loads LPA-11 microcode upon power recovery 
or upon request from LALOAD 

RSX-11M librarian 

DMF-32 lineprinter driver 

Librarian Utility 

Linker 

Login/logout utility 

Line printer driver 

MACRO-11 assembler 

VAX-11 MACRO assembler 

Mail Utility 

Command procedure used by DECnet mail 
Default MAIL editing command procedure 
Shared memory mailbox driver 

MCR command interpreter 


tan 
= 


ner 


1. Not supported by DIGITAL. 
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Table A-1l (Cont.): 


File Name 


MERGE.EXE 
MESSAGE. EXE 
MIRROR.COM 
MIRROR. EXE 
MONITOR. EXE 
MP. EXE 
MP.STB 
MTAAACP. EXE 
NCP.EXE 
NETACP. EXE 
NETDEF.STB 
NETDRIVER. EXE 
NML.COM 
NML. EXE 
NOTICE. TXT 


OPCCRASH. EXE 
OPCOM. EXE 
PADRIVER. EXE 
PAGEFILE.SYS 
PARAMS. DAT 
PAT. EXE 
PATCH. EXE 
PHONE. COM 
PHONE. EXE 
PIP, EXE 
PRTSMB. EXE 
PUDRIVER.EXE 
QUEMAN. EXE 
RECLAIM. EXE 
REMACP. EXE 
RENAME. EXE 
REPLY. EXE 
REQUEST. EXE 
RMS. EXE 
RMSDEF.STB 
RMSSHARE. EXE 
RST. EXE 
RSX.EXE 


RTB. EXE 
RTPAD,. EXE 
RTTDRIVER. EXE 
RUNDET. EXE 
RUNOFF. EXE 
SCSDEF.STB 
SCSLOA. EXE 
SDA. EXE 
SEARCH. EXE 
SECDMC.SYS 
SECDP.SYS 
SECDQ.SYS 
SECDU.SYS 
SECDUP.SYS 
SECDUV.SYS 
SET. EXE 


FILES OF THE VAX/VMS SYSTEM 


Files Contained in Directory [SYSEXE] 


Description 


Merge Utility 

Message compiler 

MIRROR start-up procedure 

DECnet node loopback server 

Monitor Utility 

VAX-11/782 multiprocessing code 

Symbol table for MP.EXE 

Magnetic tape ancillary control process 

Network control program 

DECnet ancillary control process 

Symbol table for network definition 

DECnet logical link driver 

NML server start-up procedure 

DECnet network management listener 

Text file that can contain announcements to 
system users 

System shutdown utility 

Operator communications utility 

C1780 port driver 

System paging file 

Data file for parameter values 

RSX-11M object module patch utility 

VAX-11 image file patch utility 

PHONE start-up procedure 

Phone Utility 

RSX-11M peripheral interchange utility 

Print symbiont 

CI UDA port driver 

Queue managing utility 

CONVERT/RECLAIM image 

Remote device ACP 

File rename utility 

Message broadcasting facility 

Operator request facility 

Record Management Services 

Global definitions for VAX-11 RMS structures 

File sharing utility program 

RMS-11 file restoration utility 

RSX-11M application migration executive main 
program 

Utility that writes an RT-11l bootstrap on disk 

Remote terminal command interface 

Remote terminal driver 

Facility that runs detached images 

Text formatting utility 

Symbol table for loadable routines 
Loadable routines used by SCS 

System Dump Analyzer Utility 

File search utility 

DECnet downline secondary loader for DMC1l1l 

DECnet downline secondary loader for DPll 

DECnet downline secondary loader for DPll 

DECnet downline secondary loader for DQI11 

DECnet downline secondary loader for DUP11 

DECnet downline secondary loader for DUVI11 

SET command processor 


(continued on next page) 


Table A-1l (Cont.): 


File Name 


SETPO. EXE 
SHOW. EXE 
SHUTDOWN. COM 
SLP.EXE 
SORT32. EXE 
SOS.EXE 

SRT. EXE 
STABACKUP. EXE 
STARTUP. COM 
STARTUP. MIN 
STASYSGEN. EXE 
STOPREM. EXE 
SUBMIT. EXE 
SUMSLP. EXE 
SWAPFILE.SYS 
SYE.EXE 

SYS. EXE 
SYS.MAP 
SYS.STB 
SYSBOOT. EXE 
SYSDEF.STB* 
SYSDUMP. DMP 
SYSINIT. EXE 
SYSLOA730. EXE 
SYSLOA750. EXE 
SYSLOA780. EXE 
SYSUAF.DAT 
SYSUAF.RL2 
TCX. EXE 

TECO. EXE 1 
TERDMC. SYS 
TERDP. SYS 
TERDO. SYS 
TERDU. SYS 
TERDUP. SYS 
TERDUV. SYS 
TFDRIVER. EXE 
TKB. EXE 
TMDRIVER. EXE 
TOC. EXE 
TSDRIVER.EXE 
TTDRIVER. EXE 
TTRDVFY. EXE 
TYPE. EXE 

UFD. EXE 
UNLOCK. EXE 
VERIFY. EXE 
VMB.EXE 
VMOUNT. EXE 
VMSHELP. EXE 
WRITEBOOT. EXE 
XADRIVER. EXE 


FILES OF THE VAX/VMS SYSTEM 


Files Contained in Directory [SYSEXE] 


Description 


SET MESSAGE command processor 

SHOW command processor 

System shutdown command procedure 
RSX-11M source file editing utility 
SORT command processor 

SOS text editor 

SORT-11 utility 

Stand-alone Backup Utility 

System start-up command procedure 
System minimum start-up command procedure 
Stand-alone System Generation Utility 
Stop REMACP utility 

Batch job submission utility 

Source file editor 

System swap file 

Utility that formats the error log file 
Operating system image file 

Map of the operating system 

Global symbol tablé of operating system 
System bootstrap utility 

Global definitions for executive structures 
System dump file 

System Generation and Configuration Utility 
Operating system initialization image 
VAX-11/730 system image file 

VAX-11/750 system image file 

VAX-11/780 system image file 

User authorization data file 

Unmodified copy of SYSUAF.DAT 

Runoff indexing utility 

TECO text editor 

DECnet downline tertiary loader 

DECnet downline tertiary loader 

DECnet downline tertiary loader 

DECnet downline tertiary loader 

DECnet downline tertiary loader 

DECnet downline tertiary loader 

TU78 driver 

RSX-11M task builder 

Magnetic tape driver 

Runoff table of contents utility 

TS11 Magnetic tape driver 

Terminal driver 

Auxiliary terminal driver module 

Type utility 

User file directory creation utility 
File unlock utility 

ANALYZE/DISK STRUCTRURE image 

VAX/VMS primary bootstrap 

Volume mount utility 

Help Utility 

System volume bootblock writing utility 
Reserved for future use 


l. Not supported by DIGITAL. 
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l. 


Table A-l (Cont.): 


File Name 


XDDRIVER. EXE 
XF DRIVER. EXE 
XF LOADER. EXE 
XGDRIVER.EXE 
XMDRIVER. EXE 


XWDRIVER. EXE + 
YCDRIVER. EXE 
ZAP. EXE 


Not supported by 


Table A-2: 


File Name 


ANLRMSHLP. HLB 
DEBUG. HLB 
DISKQUOTA. HLB 
EDFHLP. HLB 
EDTHELP. HLB 
EDTVT100.DOC 
EDTVT52.D0C 
EXAMPLES.DIR 
HELPLIB.HLB 
INSTALHLP. HLB 
MATLHELP. HLB 
NC PHELP. HLB 
PATCHHELP. HLB 
PHONEHELP. HLB 
SDA. HLB 
SYSGEN.HLB 
TECO.HLB 
UAFHELP. HLB 
VMSTLRHLP. HLB 


Table A-3: 


File Name 


CDDSHR. EXE 
CLIMAC.REQ 


CONVSHR. EXE 
CRFSHR. EXE 
DCLTABLES. EXE 
DEBUG, EXE 
DELTA. EXE 
DELTA. OBJ 


FILES OF THE VAX/VMS SYSTEM 


Files Contained in Directory [SYSEXE] 





Description 


DECnet DMP-11 datalink driver 

DR32 system interconnect interface driver 

DR32 microcode loader utility 

DECnet DMF datalink driver 

DMC-11 Synchronous Communications Line Interface 
driver 

DUP-11 device driver 

DMF32 asynchronous port driver 

RSX-11M task/file octal patch utility 


DIGITAL. 


Files Contained in Directory [SYSHLP] 


Description 





Help library for ANALYZE/RMS FILE command 
Debugger help library 

Help library for Disk Quota Utility 

Help library for FDL 

EDT help library 

EDT keypad layout for VT100 

EDT keypad layout for VT52 

Examples directory 

Default (DCL) help library 

Help library for Install Utility 

Mail Utility help library 

Help library for NCP 

Help library for PATCH 

Help library for PHONE 

System Dump Analyzer help library 

Help library for SYSGEN 

TECO help library 

Help library for user authorization file 
Help library for the tailoring facility 


Files Contained in Directory [SYSLIB] 
Description 


Dummy CDD image for layered products 
Structure definitions for BLISS programs 
interfacing with the command language 
interpreter ; 
CONVERT, CONVERT/RECLAIM shareable image 
Cross-reference shareable image 

DCL command tables 

VAX/VMS debugging facility 

DELTA multimode debugging tool image 
Alternate VAX/VMS debugging tool 
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Table A-3 (Cont.): 


File Name 


DISMNTSHR. EXE 
FDLSHR. EXE 
FORDEF.FOR 
FORIOSDEF.FOR 
IMAGELIB. OLB 
LBRSHR. EXE 
LIB.MLB 
LIB.REQ 


LIBDEF.FOR 
MCRTABLES., EXE 
MOUNTSHR. EXE 
MTHDEF.FOR 
NMLSHR. EXE 
ODT. OBJ 
RMS11.0DL 
RMS11S.0DL 
RMS11X. ODL 
RMS12X. ODL 
RMSLIB.OLB 
RMSMAC.MLB 
RSXMAC.SML 


nevciun DQyvp 
NVAVINe DAL 


RSXUSR. EXE 
RTLVECTOR. OBJ 
SCRSHR. EXE 
SIGDEF.FOR 
STARLET.MLB 
STARLET. OLB 
STARLET. REQ 
SUMSHR. EXE 
SYSLIB.OLB 
TPAMAC.REQ 
TRACE. EXE 


VMSRTL.EXE 
XFDEF.FOR 


Table A-4: 


File Name 


ACCOUNTING, DAT 
CHARTYPE.DAT 
FORMSTYPE. DAT 


LPA1LISTRT.COM 


FILES OF THE VAX/VMS SYSTEM 


Files Contained in Directory [SYSLIB] 
Description 


DISMOUNT shareable image 
FDL parsing shareable image 
FORTRAN INCLUDE file: FORS symbols 

FORTRAN INCLUDE file: IOSTAT error codes 
System default shareable image library 
Librarian shareable image 

Operating system macro library 

Structure definitions of executive internals 
for use by BLISS programs 

FORTRAN program utility INCLUDE files 

MCR command tables 

MOUNT shareable image 

FORTRAN INCLUDE files: MATHS symbols 

DECnet management listener shareable image 
RSX-11M debugging tool 

RMS-11 sample overlay description 

RMS-11 overlay descriptor 
RMS-11 overlay descriptor 
RMS-11 overlay descriptor 
RMS-11 object library 

RMS-11 macro library 

RSX-11M compatibility mode m 


Shareable image RSX-11M 


b 


r 
: 
wan 
av 


ro 


lint 
1tic 


ry 


we 
Ct 
+o 


» 


ac 
1 pp : 
migration executive 
Shareable image of RSX-11M 
migration executive 
VMSRTL.EXE vector (reserved for DIGITAL use) 
RTL terminal screen procedures shareable image 
FORTRAN program utility INCLUDE files 

System macro library 

System object library and Run-Time 

Library 

User interface structures for use by BLISS 
programs 

Source update merge shareable image 

RSX-11M object library . 
Structure definitions for BLISS programs using 
TPARSE 

VAX/VMS error traceback facility 

Run-Time Library shareable image 

Definitions available for programs using DR780 
Support routines 


application 


Files Contained in Directory [SYSMGR] 


Description 


Accounting data file 

Line printer characteristics for print 
symboint 

Line printer forms description for print 
symbiont 

LPA11 site-specific start-up command procedure 
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Table A-4 (Cont.): 


File Name 


NETICP.comt 
OPERATOR. LOG 
RTTLOAD. COM 
STARTNET. COM 
SYSHUTDWN. COM 


SYSTARTUP.COM 


VMS IMAGES. COM 
VMSIMAGES. DAT 


Table A-5: 


File Name 


QTOSYM.MSG 
SOS.HLP 

SYSMSG, EXE 
SYSMSG. TLB 


Table A-6: 


File Name 


APPEND, PIP 

DMPASRC.DMP 
DMPBYOC. DMP 
DMPDATA. DMP 
DMPDCWD. DMP 


MCLBR1.MAC 
MCLBR2.MAC 
MCLBR3.MAC 
OBJLBR1.OBJ 
OBJLBR2. OBJ 
OBJLBR3. OBJ 
PATCHED. PAT 
PATCHPAT. OBJ 
PIPDATA. PIP 
RANDOM. FLX 
SATSSFO1. EXE 


SATSSF02. EXE 
SATSSF03.EXE 
SATSSF04. EXE 
SATSSFO5. EXE 
SATSSF06. EXE 
SATSSF0O7. EXE 


FILES OF THE VAX/VMS SYSTEM 


Files Contained in Directory [SYSMGR] 


Description 


DECnet checkout procedure 

Operator message log file 

Remote terminal loader 

DECnet start-up procedure 

Site-specific system shutdown command 
procedure 

Site-specific system start-up command 
procedure 

Invoked at start-up to install known images 
Data file for VMSIMAGES.COM 





Requires DECnet-VAX optional product for use. 


Files Contained in Directory [SYSMSG]} 


Description 





RSX-11M compatibility mode QIO message file 
Help file for SOS text editor 

System message file 

System message file text library 


Files Contained in Directory [SYSTEST] 


Description 


Tests PIP append function 

Master file to test ASCII mode in DMP 

Master file to test byte octal format in DMP 
Good input file for DMP test 

Master file to test decimal word format in 
DMP 


Macro to test 
Macro to test 
Macro to test 


LBR utility 
LBR utility 
LBR utility 


Object module to test LBR utility 
Object module to test LBR utility 
Object module to test LBR utility 
Tests PAT utility 

Patch file to test PAT utility 
Good input file for PIP test 

Tests FLX utility 

Tests for event flag services and SSETEXV 
service 

Tests for event flag services 
Tests for logical name services 
Tests for time services 

Tests for process control services 
Tests for process control services 
Tests for process control services 
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Table A-6 (Cont.): 


File Name 


SATSSF08.EXE 
SATSSF09.EXE 
SATSSF10. EXE 
SATSSF11. EXE 
SATSSF12.EXE 
SATSSF13. EXE 
SATSSF14. EXE 
SATSSF15.EXE 
SATSSF16. EXE 
SATSSF17.EXE 


SATSSF18.EXE 


SATSSSO1. EXE 
SATSSS05. EXE 
SATSSS07. EXE 
SATSSS08. EXE 
SATSSS09. EXE 
SATSSS10. EXE 
SATSSS 22. EXE 
SATSSS 26. EXE 
SATSSS 30. EXE 


SATSSS25 EyE 


MALU JI e LAL 


SATSSS 36. EXE 
SALoSS37EXKE 
SATSSS 38. EXE 
SATSSS39. EXE 
SATSSS 40. EXE 
SATSSS41. EXE 
SATSSS 42, EXE 
SATSSS43. EXE 


SATSSS44, EXE 
SATSSS45. EXE 
SATSSS 46. EXE 
SATSSS 47. EXE 
SATSSS50. EXE 
SATSSS52.EXE 
SATSSS53.EXE 
SATSSS54. EXE 
SATSSS55. EXE 
SATSSS56. EXE 
SATSSS60. EXE 
SATSSS61. EXE 
SATSSS70. EXE 
SATSSS71.EXE 
SATSSS72. EXE 
SATSSS73. EXE 
SATSSS74. EXE 


SATSSS78.EXE 
SATSSS79. EXE 
SATSSS80. EXE 
SATSSS81. EXE 
SATSSS82. EXE 
SATSSS83. EXE 


FILES OF THE VAX/VMS SYSTEM 


Tests 
Tests 
Tests 
Tests 
Tests 
Tests 
Tests 
Tests 
Tests 
Tests 


for 
FOr 
for 
for 
for 
For 
for 
for 
for 
£or 


services 


Tests 


for 


services 


Tests 
Tests 
Tests 
Tests 
Tests 
Tests 
Tests 
Tests 


Tests 
Tacte 


towtlwv 


Tests 
Tests 
Tests 
Tests 
Tests 
Tests 
Tests 
Tests 


for 
for 
for 
for 
for 
for 
for 
for 
for 


for 


for 
for 
for 
for 
for 
for 
£6" 
for 


services 


Tests 
Tests 
Tests 
Tests 
Tests 
Tests 
Tests 
Tests 
Tests 
Tests 
Tests 
Tests 
Tests 
Tests 
Tests 
Tests 
Tests 


for 
for 
for 
for 
for 
for 
for 
for 
for 
for 
for 
for 
for 
for 
for 
for 
for 


disabled) 


Tests 
Tests 
Tests 
Tests 
Tests 
Tests 


for 
for 
for 
for 
for 
for 


Files Contained in Directory [SYSTEST] 





Description 


SCMEXEC and SGETMSG services 
I/O services 

send system services 

I/O services 

memory management services 
memory management services 
memory management services 
handler services and S$ADJ 

SFAO services and SSNDERR 
SINPUT, SOUTPUT, S$QIO, and SQIOW 
SCREPRC, S$SETPRV, and SUNWIND 
I/O services 

send message services 
SCREMBX, SDELMBX services 
SBRDCST service 

SFAO, SFAOL SERVICES 

SGETMSG and $PUTMSG services 
condition handling services 
timer and AST services 
logical name services 

SCREPRC service 

SDELPRC service 

SSUSPND service 

SRESUME service 

SHIBER service 

SWAKE service 

SEXIT service 

SFORCEX service 

exit- and change mode-handling 


SSETPRN service 

SSETPRI service 

SSETRWM service 

SSETPRV service 

SASCEFC, SDACEFC services 
SDLCEFC service 

SSETEF service 

SCLREF service 

SREADEF service 

wait services 

time conversion services 
SSCHDWK, SCANWAK services 
SEXPREG service 

SCNTREG service 

SCRETVA service 

SDELTVA service 

global section services (currently 


SLKWSET, SULWSET services 
SLCKPAG, SULKPAG services 
SPURGWS service 
SADJWSL service 
SSETPRT service 
SSETSWM service 
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File Name 


SATSSS90. EXE 
SATSSS91.EXE 
SATSUTO1. EXE 


SATSUT04. EXE 
SATSUTO5. EXE 
SATSUT06. EXE 
SATSUTO7. EXE 
SATSUTO8. EXE 
SATSUTO9. EXE 
SATSUT10.EXE 
SATSUT11.EXE 
SATSUT12. EXE 
SATSUT13.EXE 
SATSUT14. EXE 
SLPDATA.SLP 
SLPLIST.SLP 
SLPOUT.SLP 
SMFILE1. DAT 
SMFILE2. DAT 
SMFILE3. DAT 
SMFILE4. DAT 
SORT. DAT 
SORTED. FLX 
TSTOIA. EXE 
TSTO1B.EXE 
TSTO2A.EXE 
TSTO3A.EXE 


TSTO3B.EXE 
TSTO6A. EXE 
TSTO7A. EXE 
TST1IA.EXE 
TST11B.EXE 
TST12A.EXE 
TST12B.EXE 
TST15A.EXE 
TST16A.EXE 
TST16B.EXE 
TST16C.EXE 
TST17A. EXE 
TST17B.EXE 
TST20A. EXE 


TST20B.EXE 


UETCOMP00.COM 


FILES OF THE VAX/VMS SYSTEM 


Files Contained in Directory [SYSTEST] 


Description 


Tests for change mode services 
Tests for SADJSTK service 


Utility 


SATSSS35 


Utility 
Utility 
Utility 
Utility 
Utility 
Utility 
Utility 
Utility 
Utility 
Utility 
Utility 


module 


module 
module 
module 
module 
module 
module 
module 
module 
module 
module 
module 


for 


for 
for 
for 
for 
for 
for 
for 
for 
for 
for 
for 


SATSSF05, SATSSF18, and 
SATSSS50 
SATSSS38 
SATSSS40 
SATSSS61 
SATSSS37, 
SATSSS41 
SATSSS52 
SATSSS56 
abort feature 
SATSSS42 

SATSSS 36 


SATSSS45 


Input data to test SLP utility 

Good output file for SLP test 

Good output file for SLP test 

Master data file for VAX-11 SORT test 
Master data file for VAX-11 SORT test 
Master data file for VAX-11 SORT test 
Master data file for VAX-11 SORT test 
Input data file for VAX-11 SORT tests 
Tests FLX utility 

Test for QIO, QIOW (RSX~11M directive) 
Test for QIO, QIOW (RSX-11M directive) 
Test for event flags (RSX-11M directive) 
Test for GET TIME, MARK TIME, RUN (RSX-11M 
directive) 

Test for GET TIME, 
directive) 

Test for MCR command line, specify SST vector 
table (RSX-11M directive) 

Test for AST services (RSX-11M directive) 
Test for SUSPEND, RESUME (RSX-11M directive) 
Test for SUSPEND, RESUME (RSX-11M directive) 
Test for ABORT, EXIT-IF (RSX-11M directive) 
Test for ABORT, EXIT-IF (RSX-11M directive) 
Test for ASSIGN LUN, GET LUN (RSX-11M 
directive) 

Test for CANCEL SCHEDULED requests (RSX-11M 
directive) 

Test for CANCEL SCHEDULED requests (RSX-11M 
directive) 

Test for CANCEL SCHEDULED requests (RSX-11M 
directive) 

Test for CANCEL MARK TIME request 
directive) 

Test for CANCEL MARK TIME request (RSX-11M 
directive) 

Test for GET TASK PARAMS, 
(RSX-11M directive) 

Test for GET TASK PARAMS, 
(RSX-11M directive) 

Main script for compatibility mode utility 
tests 


MARK TIME, RUN (RSX-11M 


(RSX-11M 


REQUEST, RUN 


REQUEST, RUN 
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File Name 


UETCOMPO00.DAT 
UETCOMP02.COM 


UETCOMSOO0. EXE 
UETCSOSO1. DAT 
UETCSOS02.CMD 
UETCSOS03. DAT 
UETDISKOO. EXE 
UETDMPF00.EXE 
UETDNETOO.COM 
UETDNETOO. DAT 
UETDR1WO0. EXE 
UETDR7800. EXE 
UETFORTO1. DAT 
UETFORT97. EXE 
UETFORT98. EXE 
UETFORT99. EXE 
UETINITOO. EXE 


UETINITO1. EXE 
UETLOADOO. DAT 


UETLOADO2. COM 
UETLOADO3.COM 
UETLOADO4. COM 
UETLOADO5. COM 
UETLOADO6. COM 
UETLOADO7. COM 
UETLOADO8. COM 
UETLOADO9. COM 
UETLOAD10.COM 
UETLOAD11.COM 
UETLOCKOO. EXE 
UETLPAKOO. EXE 
UETMA7800. EXE 
UETMEMY0O1. EXE 
UETNATVOO. DAT 
UETNETSOO. EXE 
UETNRMSOO.COM 
UETNRMSOO. DAT 
UETNRMSO1. EXE 
UETNUTLOO. DAT 
UETNUTLOO. COM 
UETP. COM 

UETPHASOO. EXE 
UETSSMMOO0. EXE 
UETSUPDEV. DAT 
UETTAPE00. EXE 
UETTTYSO0. EXE 
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Files Contained in Directory [SYSTEST] 


Description 


Data file for compatibility mode utility test 
Main script for RSX-11M executive directive 
test 

DMC and DMR test file 

Data file for SOS test 

Commands for SOS test 

Known good data after SOS editing 

Disk device test 

DMP and DMF32 test file 

Command procedure for DECnet test 

Data file for DECnet test 

DR11W device test 

DR780 device test 

FORTRAN data file used by UETFORTO1 
Compiled version of UETFORTO1 for load test 
Compiled version of UETFORTO2 for load test 
Compiled program for load test 

Gets VAX/VMS configuration and builds 
UETINIDEV. DAT 

Quick checks all devices for testability 
Controls load test with various numbers 

of users 

User script for load test 

User script for load test 

User script for load test 

User script for load test 

User script for load test 

User script for load test 

User script for load test 

User script for load test 

User script for load test 

User script for load test 

Local lock manager test file 

LPA11-K test file 

MA780 test file 

Tests high page faulting rates in load test 
Script that runs VAX/VMS system service tests 
DECnet counter test file 

Main script for VAX-11 RMS tests 

VAX-11/RMS test data file 

Test program to exercise VAX-11l RMS functions 
Native mode utility data file 

Native mode utilities command procedure 
Main command procedure for entire UETP 
Phase controller test file 

Memory management system service test file 
Supported device data file 

Tests magnetic tapes on one controller 
Tests terminals for one controller 
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Files Contained in Directory [SYSUPD] 





File Name 


AUTOGEN. COM 
BLISSREQ. TLR 
BOOTBLDR. COM 


BOOTUPD. COM 


CONSCOPY. COM 


DECNET. TLR 
DEVELOP. TLR 
DXCOPY. COM 


EXAMPLES. TLR 
FILETOOLS. TLR 
HELP. TLR 
LIBRARY. TLR 
LINEPAGE. COM 


LINEPAGE. DAT 
MANAGER. TLR 
MISCTOOLS. TLR 
OBSOLETE.TLR 
QUEUES.TLR 
REQUIRED. TLR 
RSX.TLR 
SETDEFBOO,. COM 


STABACKIT. COM 
SWAPFILES.COM 
TEXTTOOLS. TLR 
UETP. TLR 

VMSINSTAL.COM 
VMSKITBLD.COM 
VMSKITBLD. DAT 


VMSTAILOR. COM 


VMSUPDATE. COM 





Description 


Command procedure to determine parameter values 
List of files in the BLISS tailoring group 
Multiprocessing console floppies command 
procedure 

Command procedure that updates VAX/VMS bootstrap 
file on console floppy diskette 

Command procedure that copies console floppy 
diskette 

List of files in the DECnet tailoring group 

List of files in the DEVELOP tailoring group 
Command procedure that copies files from console 
floppy diskette and restores files to floppy 
diskette 

List of files in the EXAMPLE tailoring group 
List of files in the TOOLS tailoring group 

List of files in the HELP tailoring group 

List of files in the LIBRARY tailoring group 
Command procedure to change number of lines per 
page 

Datafile used by LINEPAGE.COM 

List of files in the MANAGER tailoring group 
List of files in the MISCTOOLS tailoring group 
List of files in the OBSOLETE tailoring group 
List of files in the QUEUES tailoring group 

List of files in the REQUIRED tailoring group 
List of files in the RSX tailoring group 

Command procedure that sets default boot command 
file 

Command procedure that builds stand-alone BACKUP 
to media 

Command procedure that creates swapping, paging, 
and system dump files of appropriate size for 
system being installed 

List of files in the TEXTTOOLS tailoring group 
List of files in the UETP tailoring group 
Command procedure to install EDTCAI and 
maintenance updates 

Command procedure that builds and copies VAX/VMS 
distribution disk 

List of files in VAX/VMS system that drives 
VMSKITBLD. COM 

Tailoring facility command procedure (Supported 
only on VAX-11/730) 

System update command procedure 


A-12 


Table A-8: 


File Name 


ADDRIVER.MAR 
CONNECT. COM 


DRCOPY. PRM 
DRCOPYBLD. COM 
DRMAST.MAR 
DRMASTER. FOR 
DRSLAVE. FOR 
DRSLV.MAR 
GBLSECUFO.MAR 


LABCHNDEF.FOR 
LABIO.OPT 


LABIOACQ. FOR 
LABIOCIN.MAR 


LABIOCIN, OPT 
LABIOCOM.FOR 


LABIOCOMP. COM 
LABIOCON. FOR 


LABIOLINK. COM 
LABIOPEAK.FOR 
LABIOSAMP.FOR 


LABIOSEC.FOR 
LABIOSTAT. FOR 


LABIOSTRT. COM 
LABMBXDEF. FOR 
LBRDEMO.COM 
LBRDEMO.FOR 
LBRMAC.MAR 
LPATEST. FOR 
LPMULT.B32 
PEAK.FOR 
SCRFT.MAR 


TDRIVER.MAR 
TESTLABIO.FOR 
USSDISP.MAR 


USSLINK. COM 
USSTEST.MAR 


USSTSTLNK. COM 
XADRIVER.MAR 
XALINK.MAR 
XAMESSAGE.MAR 
XATEST. COM 
XATEST. FOR 
XIDRIVER.MAR 
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Files Contained in Directory [SYSHLP. EXAMPLES] 


Description 


Example device driver for AD11-K 

Command procedure that connects device for LABIO 
system 

Parameter file for DRCOPY routines 

Command procedure to build DRCOPY.EXE 

VAX-11 RMS interface for DRMASTER.FOR 

Master subroutines for DRCOPY 

Slave subroutines for DRCOPY 

VAX-11 RMS interface for DRSLAVE.FOR 

Opens file that is to be used as a global 
section for LABIO system 

Defines information associated wth each A/D for 
LABIO system 

Linker options file for linking modules to be 
used in LABIO system 

Acquires data for LABIO system 

Contains connect-to-interrupt call for LABIO 
system 

Linker options filé for linking LABIO DATA ACQ 
Attaches a LABIO user program to the LABIO 
system modules of the LABIO system 

Command procedure to compile and assemble the 
modules of the LABIO system 

Handles user requests and modifies the data base 
for LABIO system 

Command procedure to link LABIO system 
Samples channel for peak data in LABIO system 
Samples channel in intervals, reporting date, 
time, and average value on logical device for 
LABIO system 

Places LABIO SECTION on page boundary 
Displays status of the A/D channels for LABIO 
system 

Command procedure to start LABIO system 
Defines mailbox block for LABIO system 
Command procedure to create Librarian DEMO.EXE 
Librarian demo (first part) 

Librarian demo (second part) 

LPA11-K test program 

Example program for line printer 

Peak selection routine in LABIO system 
Optional screen package (SCRS$...in RTL) 
extension to handle foreign terminals 
Template for user-written driver 

Tests LABIO sytem 

Sample user system service dispatch 

and service examples 

Link command procedure for USSDISP 

Sample program to invoke one of the example 
user services implemented in USSDISP 

Link command procedure for USSTEST 

DR-1ll driver 

Sample DR11W to DR11W link program 

DR-1ll test program 

Used to set up XALINK.MAR 

Companion program for XAMESSAGE 

Example driver for parallel port on DMF32 
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USING THE TU58 TAPE CARTRIDGE 


This appendix supplements the information on bootstrapping a VAX/VMS 
system by describing how to perform conversational and nonstop 
bootstrap operations using the stand-alone BOOT58 program on the TU58 
tape cartridge. This appendix also describes the command procedures 
stored on the console TU58 tape cartridge and how you can manipulate 
them. 


B.1 WHEN TO BOOTSTRAP FROM THE TU58 TAPE CARTRIDGE 


In most cases it is quicker, easier, and recommended procedure, to 
bootstrap the system directly from the system disk. When you do, the 
microcode program must read and execute the boot block (block 6). If 
this block is corrupted, and the rest of the disk is intact, the only 
way to safely bootstrap the system is to use stand-alone BOOTS58. 
Later, you can use the WRITEBOOT utility to replace the bad boot block 


(see Section B.6). 


B.2 BOOTSTRAPPING THE SYSTEM USING STAND-ALONE BOOT58 


The stand-alone BOOT58 program resides on the console TU58 tape 
cartridge and is used to supplement the console subsystem's 
bootstrapping functions. When you request a bootstrap from the 
console TU58 tape cartridge (device DDAO), the console subsystem 
microcode reads the TU58 boot block (block 0) into memory and executes 
Dts The effect of executing the TU58 boot block is to load and 
transfer control to stand-alone BOOT58. 


With stand-alone BOOT58, you can bootstrap the system in either of the 
following ways: 


e Conversational -- Request that SYSBOOT stop and allow you_ to 
modify the system parameters that configure the system. 


e Nonstop -- Allow SYSBOOT to run to completion without your 
intervention. 


Stand-alone BOOT58 commands are used to request the bootstrapping of 
the system. The console TU58 tape cartridge contains a number of 
command procedures that contain the necessary stand-alone BOOT58 
commands to bootstrap the system from the console TU58 tape cartridge. 
Appendix C documents the BOOT58 commands. 
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The console TU58 tape cartridge contains these files in two sets: 


Table B-l lists the names of the bootstrap command procedures 


A conversational set that bootstraps the system from. the 
specified device and then stops’ in the SYSBOOT program to 
accept changes to the parameters used to configure the system. 


See Section B.2.1. 


A nonstop set that bootstraps the system 
SYSBOOT  -for 
See Section B.2.2. 


device without 
parameter values. 


stopping in 


console TU58 tape cartridge. 


Table B-1: 


Type of Command Procedure 


from 


VAX/VMS Boot Command Procedures 


Name of Command Procedure 


Conversational bootstrap DMOGEN 

from RKO7 DM1GEN 
DM 2GEN 
DM 3GEN 
DMAGEN 
DMBGEN 

Conversational bootstrap DB OGEN 

from RMO3, RM80, RPO6, DB 1GEN 

RPO7, or RMO5 DB 2GEN 
DB 3GEN 
DB 4GEN 
DB 4GEN 
DB 5GEN 
DB6GEN 
DB 7GEN 
DBAGEN 
DBBGEN 

Conversational bootstrap DUOGEN 

from RA60, RA80, or 

RA81, controlled by a 

UDA 

Nonstop bootstrap from DMOBOO. CMD 

RKO7 DM1BO00. CMD 


DM 2B00. CMD 
DM 3B00. CMD 


DMABOO. CMD 
DMBBOO.CMD 
Nonstop bootstrap from DB OBOO. CMD 
RMO3, RMO5, RM80, RPOG6 DB 1B0O0.CMD 
or RPO7 DB 2B00. CMD 
DB 3B00. CMD 


Nonstop bootstrap from 
RA60, RA80, RA81 


Controlled by a UDA 





DB 4B00. CMD 
DB 5B00. CMD 
DB 6BO00. CMD 
DB7B00. CMD 
DBABOO. CMD 
DBBBOO. CMD 


DUOBOO. CMD 


specified 
changes 
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B.2.1 Conversational Bootstrap Using Stand-Alone BOOT58 

To bootstrap the system using the stand-alone BOOT58 program and 
request that SYSBOOT stop to allow you to change parameter values, 
proceed as follows: 


1. Insert the console TU58 tape cartridge (part description: 
TUS8#1 VAX-11/750 Local Console) in to the console drive. 


2. See that the rotary key switch on the processor control panel 
is set to LOCAL, 


3. Set the POWER-ON-ACTION switch to HALT. 
4, Press CTRL/P to obtain the console program prompt >>>. 


5. Enter the following console BOOT command to boot the TU58 
tape cartridge: 


>>>B DDAO 


6. In response to the BOOT58 prompt, enter the name of a command 
procedure in the following command format: 


BOOT58>@Dx yGEN 
@ 
Indicates that the rest of the line contains the name of 
a command procedure located on the console TU58 tape 
cartridge. 
xX ‘ 
Indicates the device type of the desired bootstrap 
volume: 
B -- RMO3, RM80, or RPO6 
M -- RKO7 
y 


Indicates the unit number of the desired bootstrap device 
volume. Specify a number in the range of 0 through 7. 
When SYSBOOT is ready to accept commands, it prompts as follows: 
SYSBOOT> 
You can now issue any one of the SYSBOOT commands listed in Chapter 5. 


If your system will not boot, you can use the following sequence of 
SYSBOOT commands to boot uSing default system parameter values: 


SYSBOOT> USE DEFAULT 
SYSBOOT> CONTINUE 


The following example shows a console printout obtained by 
bootstrapping the system uSing the stand-alone BOOT58 program and 
altering the WSMAX system parameter: 
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>>>B DDAO 


$3 
BOOT58>@DMOGEN 

! 

! DMO CONVERSATIONAL BOOT COMMAND FILE - DMOGEN 


BOOT FROM DMO AND STOP IN SYSBOOT TO ALTER PARAMETER VALUES 


D/G 01 ! CARTRIDGE DISK 


D/G 1] FFEOOO BASE OF UNIBUS I/O PAGE 


D/G 2: 3FF 20 CSR ADDRESS OFFSET 


-_ 


D/G 3 0 ! CONTROLLER UNIT = 0 

D/G 4 0 ! BOOT BLOCK LBN (UNUSED) 

DG: - 5: 1 ! SOFTWARE BOOT FLAGS (CONVERSATIONAL) 
D/G E 200 ! ADDRESS OF WORKING MEMORY + *X200 
LOAD VMB.EXE/START: 200 ! LOAD PRIMARY BOOTSTRAP 

START 200 ! START PRIMARY BOOTSTRAP 


SYSBOOT> SET WSMAX 512 


SYSBOOT> CONTINUE 
VAX/VMS Version V3.2 <date hh:mm> 


Opcom, <date hh:mm:ss.ss>, logfile initialized, operator= OPA0: 


Login quotas - Interactive limit=64, Current interactive value=0 
SYSTEM job terminated at <date hh:mm:ss.ss> 


B.2.2 Nonstop Bootstrap Using Stand-Alone BOOTS58 


To bootstrap the system using the stand-alone BOOT58 program, without 
stopping in SYSBOOT, proceed as follows: 


1. Insert the console TU58 (part description: TU58#1 VAX-11/750 
Local Console) into the console drive. 


2. See that the rotary key switch on the processor control panel 
is set to LOCAL. 


3. Set the POWER-ON-ACTION switch to HALT. 
4, Press CTRL/P to obtain the console program prompt >>>. 


5. Issue the following console BOOT command to bootstrap the 
LU5e: 


>>>B DDAO 
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6. In response to the BOOT58 prompt, type the name of a 
bootstrap command procedure in the following format: 


BOOT58>@DxyBOO. CMD 
@ 
Indicates that the rest of the line contains the name of 
a command procedure located on the console TU58. 
x 
Indicates the device type of the desired bootstrap 
volume: 
B -- RMO3, RM80, or RPO6 
M -- RKO7 
y 


Indicates the unit number of the desired bootstrap 
volume. Specify a number in the range of 0 through 7. 


Note that you can also type a command procedure in the following 
format to perform a nonstop bootstrap operation: 


BOOT58> BOOT 0 ddcu 


Typing BOOT DMO is equivalent to typing @DMOBOO.CMD. If you use the 
long form (that is, @DxyBOO.CMD), the contents of the command 
procedure are displayed on the console terminal. 


The following example shows a console printout obtained by 
bootstrapping the system using the command procedure DMOBOO.CMD: 


>>>B DDAO 
SB 


BOOT58>@DMOBOO. CMD 
! 


: DMO BOOT COMMAND FILE —- DMOBOO.CMD 
! 


D/G 01 ! CARTRIDGE DISK 

D/G 1 FFEOOO ! BASE OF UNIBUS I/O PAGE 

D/G 2 3FF20 ! CSR ADDRESS OFFSET 

D/G 3 0 ! CONTROLLER UNIT = 0 

D/G 4 0 ! BOOT BLOCK LBN (UNUSED) 

D/G 5 0 ! SOFTWARE BOOT FLAGS 

D/G E 200 ! ADDRESS OF WORKING MEMORY + “~X200 
LOAD VMB.EXE/START: 200 ! LOAD PRIMARY BOOTSTRAP 

START 200 ! START PRIMARY BOOTSTRAP 


VAX/VMS Version V3.2 <date hh:mm> 
Opcom, <date hh:mm:ss.ss>, logfile initialized, operator= _OPAOD: 
Login quotas - Interactive limit=64, Current interactive value=0 


SYSTEM job terminated at <date hh:mm:ss.ss> 
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B.3 THE DEFAULT BOOTSTRAP COMMAND PROCEDURE 


VAX/VMS provides a command procedure named SETDEFBOO. COM that 
simplifies the copying of the default bootstrap command procedure to 
the console TU58. To use SETDEFBOO, log in under the system manager's 
account, SYSTEM, then type the following: 


S$ @SYSSUPDATE: SETDEFBOO 


SETDEFBOO asks you to confirm that the TU58 is in the console drive 
and requests the name of the bootstrap command procedure that is to 
become the default: 


Is the console medium ready to be mounted? (Y/N): 
Enter name of default boot command file: 


Once you enter the name of the appropriate bootstrap command 
procedure, SETDEFBOO copies the specified bootstrap command procedure 
to DEFBOO.CMD on the console TU58. When it finishes copying, 
SETDEFBOO issues the following message: 


Default boot command file now replaced with <file-name> 


Are you satisfied with this file as the default boot 
command file? (Y/N) 


If you reply NO, the procedure will ask you for the name of the 
default boot command file again. If you are satisfied with this file 
as the default boot command file, answer YES and proceed. 


B.4 REBOOTING USING THE DEFAULT BOOTSTRAP COMMAND PROCEDURE 


Under normal BOOT58 operation, you do not need to interrupt’ the 
bootstrapping of the system to type commands to SYSBOOT; that is, 
parameter values have been established. Rather, you can bootstrap the 
system uSing the default bootstrap command procedure that you copied 
to the file DEFBOO.CMD. To do so, proceed as follows: 


1. Shut down the system by executing the following command 
procedure: 


$ @SYSSSYSTEM: SHUTDOWN 


This command procedure prompts for the number of minutes 
until system shutdown, the reason for the shutdown, and 
whether to spin down the disks. 


2. In response to the statement, "SYSTEM SHUTDOWN COMPLETE - USE 
CONSOLE TO HALT THE SYSTEM," halt the processor by pressing 
CTRL/P. 


3. In response to the console prompt (>>>), type: B DDAO:. 


4. In response to the BOOTS58 prompt (BOOTS58>), type: BOOT. 


B.5 COPYING FILES TO OR FROM THE CONSOLE TU58 TAPE CARTRIDGE 


Occasionally, you may want to copy files other than DEFBOO.CMD from 
the console TUS58, edit them, and place them back on the cartridge. 
VAX/VMS provides a command procedure named DXCOPY.COM to simplify the 
copying of text files (that is, ASCII files such as bootstrap command 
procedures) to and from the console TU58. 
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To request the execution of the command procedure DXCOPY.COM and_ to 
copy the files, proceed as follows: 
1. Invoke the command procedure by typing: 


S @SYSSUPDATE:DXCOPY 


NO 
o 
4 


he command procedure asks whether the console TU58 is 
mounted: 


Is the system console storage medium mounted (Y/N)?: 
Mount the TU58 and type YES. 


3. The command procedure then asks whether the copy operation is 
from the console TU58: 


Copy from console medium (Y/N) ?: 


Type YES to indicate a copy from the console TU58 to the 
default directory. 


Type NO to indicate a copy from the current default directory 
to the console TU58. 


4, Finally, the command procedure requests the name of the file 
to be copied to or from the console TU58. Type the name of 
the file and press RETURN. 


B.6 WRITEBOOT UTILITY 


This section discusses the WRITEBOOT Utility, which writes a boot 
block on a bootable disk. 


The normal bootstrap operation on the VAX-11/750 is done from the boot 
block (block 0) of the system disk. If this block is corrupted, the 
system can only be bootstrapped from the TU58. Once the system is 
running again, the bad boot block can be rewritten by using the 
WRITEBOOT Utility. 
To invoke WRITEBOOT, type: 

S$ RUN SYSSSYSTEM:WRITEBOOT 
WRITEBOOT will ask you three questions. The first is: 

Target system device (and boot file if not VMB.EXE):? 
Enter the name of the device on which you want to rewrite the boot 
block (DMAO for example). The target system device should be 
specified as any VAX/VMS disk device (ddcu): 

dd is the code name for the device type 

c is the controller designation 


u is the unit number 


For example, DMAO would be an RKO7 on RK611 controller A, device 
number 0. The second question is: 


Enter VBN of boot file code (default is one): 
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If you are rewriting the boot block, press RETURN. The third question 
is: 
Enter load address of primary bootstrap in HEX (default is 200): 
Again, if you are rewriting the boot block, press RETURN. 


WRITEBOOT will then write the boot file that you specified in the 
first line, to the address that you entered in the third line. 


NOTE 
To use WRITEBOOT you need the LOG I0 
privilege. 


The WRITEBOOT Utility may issue the following error messages. 


You lack LOG IO privilege 
Explanation: You do not have the correct privilege to use 
WRITEBOOT. Consult with your system manager. 

You lack READ and/or WRITE access to TARGET DEVICE. DISMOUNT and reMOUNT 


Explanation: The access to the target device is limited. Check 
the write protect button. 


VBN must be >= 1 


Explanation: You cannot specify a zero as the Virtual Block 
Number (VBN). 
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BOOT58 COMMANDS 


This appendix lists and describes the commands that can be entered _ to 
the stand-alone BOOT58 program. The commands are listed in 
alphabetical order. 
BOOT [device-name] 
Bootstraps the system from the specified device. If you omit the 
device name, the system is bootstrapped using the default 
bootstrap command procedure (DEFBOO.CMD). Note that you cannot 
enter the name of a command procedure to the BOOT command and you 
cannot specify this command within a command procedure. 
DEPOSIT [loc-qual,size-qual] location value 
Deposits a value in the specified location. The location is 
interpreted according to the location and size qualifiers. The 
location qualifier can be expressed as follows: 
/G general register 
ape internal process register 
/P physical memory 
The size qualifier can be expressed as follows: 
/B byte 
/W word 
/L longword 
If you do not specify the location and size qualifiers, the 
default values established by a previous command are used. 
EXAMINE [loc-qual,size-qual] location 
Displays the contents of the specified location. The location is 
interpreted according to the location and size qualifiers. The 
location qualifier can be expressed as follows: 
/G general register 


fi internal process register 


/P physical memory 


HELP 


LOAD 
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The size qualifier can be expressed as follows: 
/B byte 
/W word 
/L longword 


If you do not specify the location and size qualifiers, the 
default values established by a previous command are used. 


Displays the BOOT58 help file at the console terminal. You 
cannot specify this command within a command procedure. 


file-spec [/START: address] 


Loads a file from the bootstrap device into memory, starting at 
the address specified with the /START qualifier. If you omit the 
/START qualifier, the file is loaded into memory beginning at the 
first free address. 


START value 


Transfers control to the value specified. You generally use this 
command with the LOAD command. 


@file-spec 


Executes the name of the command procedure specified. You cannot 
specify a command procedure file-spec of more than. six 
characters, nor can you specify nested command procedures. 
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MICRO VERIFY ERROR CHARACTERS 


Micro verify routines test the reliability of the VAX-11/750 hardware. 
At the start of the micro verify routines, a percent sign (%) is 
displayed at the console terminal. If the routines run successfully, 
a second percent sign is displayed after the first percent sign. If, 
however, an error is detected while the routines are running, a single 
error character is displayed in place of the second percent sign and 
the processor is halted in console mode. 


Table D-1 lists the possible micro verify error characters and names 
the micro verify routines associated with those characters. 


Table D-1: Micro Verify Error Characters 


Error Character Routine Name 


@ R-BUS, W-BUS, D-REG TEST 

. CACHE TEST 

TB PARITY CHECKER 

CONTROL STORE PARITY CHECKER 
M-BUS, C-REG TEST 

SCRATCH PAD TEST 

SCRATCH PAD EXPLICIT ADDR MTEMPS 
SCRATCH PAD EXPLICIT ADDR RTEMPS 
SCRATCH PAD EXPLICIT ADDR IPRS 
SCRATCH PAD EXPLICIT ADDR GPRS 
SCRATCH PAD DUAL PORT ADDRESS 
XB, IR, OSR TEST 

EX, PC PC+ISIZE TEST 

DSIZE TEST 

DSIZE TEST 

CACHE PARITY CHECKER 


SHAOOMMrTAHA WAY 
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INSTALLING OPTIONAL SOFTWARE PRODUCTS 


The procedure for performing optional software installations is 
automated, and thus’ requires little involvement on your part beyond 
(1) setting up the proper conditions for the installation and (2) 
responding to queries and prompting messages displayed as the 
installation proceeds. 


The VMSUPDATE.COM procedure drives optional software installations. 
Once invoked, it uses command procedures contained in the distribution 
media. These command procedures direct the installation procedure by 
means of queries and instructions sent to the terminal. Most queries 
require Simple YES or NO answers. You respond with Y or N, as 
appropriate. 


E.1 DISTRIBUTION KITS 


Optional software installations for the VAX-11/750 are distributed on 
TU58 cartridges (one or more depending on the installation). 


Each TU58 is labeled with both a name and aeserial number that 
differentiates it from others in the distribution kit. Check that 
your kit contains all the cartridges listed in the bill of materials. 


E.2 PREPARATIONS FOR AN OPTIONAL SOFTWARE INSTALLATION 
To prepare for the installation, do the following: 


1. Back up your system disk (see Section 3.6). Optional 
software products may delete older product versions before 
installing new ones, so it is advisable to back up your 
system disk before attempting any software installation. It 
is also advisable because a system failure at a critical 
point of the installation could leave unusable files. 


2. Log in at the console terminal under the system manager's 
account, SYSTEM. 


(If the SYSGEN parameters MOUNTMSG or DISMOUMSG at your. site 
have been set to 1, you will receive a message from OPCOM 
each time a disk, tape, or TU58 iS mounted or dismounted. 
These messages are normally disabled, but if they have been 
activated and you are installing from a console terminal, 
they will appear from one to thirty seconds after each mount 
or dismount.) 


3. Prevent users from gaining access to the system by executing 
the SHUTDOWN.COM command procedure. Then reboot the system. 
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4. Set the login quota to 0 by typing: 


$ SET LOGINS/INTERACTIVE = 0 


5. Be sure that you have set your default to the disk that is to 
receive the update. This is typically the system disk with 


the logical name SYSSSYSROOT. 


If you are installing optional software on a= system 


disk 


other than the disk from which you booted, you must define a 


logical name for the target disk. For example, if you 


are 


installing software on an RKO7 disk on the first drive, issue 


the following commands: 
S$ DEFINE TARGET DMA]: [SYSO.] 


$ SET DEFAULT TARGET: [SYSUPD] 


Note that not all optional software kits allow installation 


to a device other than the system disk. Consult 
documentation that came with the optional software kit. 


the 


6. If you are installing to the current system disk, establish 


the following default: 


S$ SET DEFAULT SYSSUPDATE 


E.3 INSTALLING OPTIONAL SOFTWARE PRODUCTS 

Type the following command to initiate the installation: 
S$ @VMSUPDATE 

You will receive the following message text at the terminal: 

VMS Update Procedure 

This command procedure performs VAX/VMS software updates and 
optional software installations for VAX/VMS Release 3. 
During this sequence, the standard console medium will not 
be present in the console drive. Therefore, the system may 
be vulnerable to a power failure or other fatal crash. If a 
system crash should occur during this period the update 
sequence can be restarted at the beginning of the first 
incomplete update. 
Dismount the current console medium. 


Please place the first cartridge in the console drive 


After placing the TU58 in the CSAl drive, you will receive 
following query: 


Are you ready to continue?: 
If you type Y, the installation proceeds. 


If you type N, the request to insert the cartridge in the drive 
the query "Are you ready to continue?" will be repeated. 


Continuation of the update is indicated by the display of 
messages: 


$MOUNT-I-MOUNTED , <label> mounted on CSAIL: 


Ee2 


the 


and 


the 


INSTALLING OPTIONAL SOFTWARE PRODUCTS 


These messages are followed by questions and prompts, the content of 
which depends on the product. 


E.4 INSTALLATION COMPLETION 

When the installation is completed, control is returned to the command 
procedure VMSUPDATE.COM, which sends’ the following messages to the 
terminal: 


Are there more kits to process?: 


If you type Y, you will receive the following request, and_ the 
installation procedure begins again. 


Please place the first cartridge in the console drive. 


If you have no further installations, type N. You then receive the 
following message and DCL prompt: 


Requested update sequence complete. 


$ 
The procedure is now complete. 


To transfer control of the system to the updated version of VAX/VMS, 
halt the processor and reboot the system. 


Finally, after installing an optional software product, you’ should 
back up the system disk. 


APPENDIX F 


BUILDING THE VAX/VMS SOURCE KIT 


The VAX/VMS source kit is a set of three magnetic tapes that contains 
the source files, object files, command files, language processors, 
and utilities necessary to build any of the standard components of the 
VAX/VMS operating system. (The languages and utilities used in this 
building operation are not Supported by DIGITAL.) 


Before you begin building, you must make sure there is enough disk 
Space available. A single component might require up to 40,000 free 
blocks. To build the entire system you will need at least one RP06 
(or its equivalent) for the source kit and one RMO5 (or its 
equivalent) to use as the target of the build (for object files, 
listings, and so on). 


To use the VAX/VMS source kit, you must mount the first reel of the 
kit (the tape labeled VMSRC1) and restore the file 
[SYSBLDCOM]SRCINSTAL.COM. (This command procedure, when invoked, will 
ask you questions in order to properly define the system building 
environment.) 


To mount the reel and restore the file, type the following DCL 
commands: moa . ee f 


ALLOCATE MTcn: 
MOUNT/FOREIGN MTcn: VMSRC1 
BACKUP MTcn:SYSBLDCOM/SELECT=(SRCINSTAL.COM) DBcn:[*...] 


When the file has been restored, dismount the tape. Then complete the 
source kit installation (for either a partial or the entire system 
build) by issuing the following DCL command: 


@DBcn: [SYSBLDCOM] SRCINSTAL. COM 


This invokes a command procedure to create a system build account 
containing the logical name definitions and private command 
definitions needed to set up the proper environment for a_e system 
build. To log in to this account, specify the username SYSTEMBUILD 
and the password CAVEAT EMPTOR. 


Finally, to obtain a general description of the source kit you can 
print a copy of the file [SYSBLDCOM]SOURCEKIT.DOC. 


APPENDIX G 


UPGRADING THE SYSTEM 


If for some reason you have not already upgraded your system from 
Version 2.5 to Version 3.0, this appendix describes the procedure you 
should follow. 


CAUTION 


Do not attempt to apply any Version 3 
maintenance updates without first 
upgrading the system to Version 3.0. 
The upgrade works only on a Version 2.5 
system. 


All that the user needs in order to perform the upgrade is the Version 
3.0 software distribution kit and a blank TU58 cartridge. 


You should read this entire appendix before attempting to do an 
upgrade to make sure you are aware of all the requirements of the 
upgrade. 


It is important to note that the upgrade procedure will work correctly 
only as long aS your system directories are consistent with those set 
up by the VAX/VMS installation procedure. If you have changed _ the 
names of the directories, or deleted files from them, the upgrade 
procedure may not work correctly. 


NOTE 


As part of the upgrade, the paging, 
Swapping, dump, and authorization files 
are purged back to one version. 
Everything in the [SYSERR] directory is 
deleted. All operator and accounting 
logs are deleted. If you want to keep 
any logs, move them to a user directory 
before starting the upgrade. It is also 
Suggested you back up your system disk 
before upgrading because some V2.5 files 
have been made obsolete by V3.0 and will 
be deleted when you upgrade. 


G.1 RESTARTABLE UPGRADE PROCEDURE 


The upgrade procedure can be restarted. The system is booted three 
times as part of the upgrade, and a restart will continue from the 
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last time the system was booted. The system manager must boot in the 
manner requested by the upgrade procedure after the last planned 
system shutdown for the upgrade to automatically continue. 


In order to make the upgrade procedure restartable at any time, the 
new Version 3.0 system files are placed in a different directory from 
the existing V2.5 system files. Therefore, at least one set of system 
files is bootable at all times. (More information on top-level system 
directories can be found in the VAX/VMS Release Notes.) 


G.2 PREPARING TO UPGRADE THE SYSTEM 


Log in on the console terminal under the system manager's account, 
SYSTEM. 


Because available disk space is always at a premium, remove all 
unwanted or redundant files before upgrading the system. You can 
remove them with the DCL commands DELETE or _ PURGE. For instance, 
because all DIGITAL optional software must be reinstalled after an 
upgrade, you can delete the existing optional software files. 


To upgrade the system, there must be a minimum of 7000 free blocks’ on 
the system disk. You can confirm the free block count with the 
following command: 


SHOW DEVICES device-name 


Note that during the upgrade, the system disk and the distribution kit 
cannot be moved from one device to another. 


Before upgrading your system, you must also back up the system disk to 
a scratch disk. Users who received magnetic tape distribution kits 
can use the stand-alone BACKUP procedure described in Section 3.6. 
Users who received RKO7 distribution kits should back up the system 
using the stand-alone Disk Save and Compress Utility documented in the 
VAX-11 Software Installation Guide, Version 2.0. When this is 
completed, boot the scratch disk, which will become the Version 3.0 
system disk. 


Make sure the POWER-ON-ACTION switch on the processor control panel is 
set to RESTART/BOOT. The upgrade will continue automatically after 
shutdowns as long as this switch is in the RESTART/BOOT position. 


G.3 UPGRADING VAX/VMS 


After bootstrapping your system with the new system disk, you are 
ready to begin the upgrade procedure. Proceed as follows at the 
console terminal: 


1. Set the boot device switch on the processor control panel to 
boot from the disk drive containing the new system disk. 


If you do not have a position for this device, set the boot 
device switch to position A to bootstrap from the TU58 
cartridge, and place your console TUS58 in the drive in the 
processor control panel. If you are booting from the TU58, 
reply YES when the upgrade procedure asks if you want to boot 
from TU58. 


2. Log in under the system manager's account, SYSTEM. 


10. 


Gi3el 
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Prevent users from logging into the system by typing: 
$ SET LOGINS/INTERACTIVE=0 


If you are running DECnet-VAX, shut down the network by 
typing: 


S$ RUN SYSSSYSTEM:NCP 
When the NCP> prompt is displayed, type: 


SET EXECUTOR STATE OFF 
To exit from NCP, type either CTRL/Z or EXIT. 


Issue a STOP/QUEUE/NEXT command for batch and print queues, 
if there are any jobs in the queues. 


These queues will be initialized during the upgrade, and any 
jobs contained in the queues will be lost. 


Place the distribution medium in the appropriate drive and 
Place the drive online. 


Execute the following DCL command: 


$ SET DEFAULT [SYSUPD] 
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S$ @VMSINSTAL 
You now receive a request to enter the device name of the 
drive holding the distribution kit. You must type your 
response in the format ddcu: dd is the device code, c, the 
controller letter, and u, the unit number. The upgrade 
procedure will abort if it believes the format is incorrect. 
At this point, the upgrade procedure displays: 

VAX/VMS V3.0 Upgrade Procedure 


A brief description of the upgrade procedure will be 
displayed, and a cautionary note about preserving files. 


The upgrade procedure then asks: 
Do you want to continue? (Y/N): 


If you respond YES, the upgrade continues to Phase l. 


Upgrade Phase 1 


The first phase of upgrade requires some user interaction. Follow the 
procedures below: 


1. 


The upgrade begins by informing you that the default editor 
for VAX/VMS V3.0 is EDT. The procedure then asks: 


Would you like SOS to be the default editor for the EDIT 
command, aS it was in VMS V2.0? (Y/N) 


Respond YES or NO to that question. 
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Next, the upgrade procedure turns off the disk quotas on the 
system disk and removes directory entries that point to 
nonexistent files. 


The procedure then asks: 
Do you want to boot from the TU58? (Y/N) 


If you do not want to boot from TU58, answer NO and _ proceed 
to step 9 below. 


If you set your boot device switch to boot from TU58 as 
described in Section G.3, you must answer YES. Make sure the 
switch position is set correctly for the upg rade to 
automatically continue. 


At this point, a new, site-specific TU58 must be created to 
allow reboot of a kernel VAX/VMS V3.0 system. 


The upgrade procedure asks you the following question: 


DEFBOO.CMD must be set to boot from your current 

system disk. 

You must set this up if it has not been done previously. 
Do you want to do this now? (Y/N) 


This means that the DEFBOO.CMD command procedure on your old 
console TU58 must be set to boot your current system disk. 
If you have already done this, enter NO and move to step 7 
below. If you have not yet done this, enter YES and proceed 
as follows: 


Answer YES when you receive this message: 


Please place the system console medium in the console 
drive. Is the console medium ready to be 
mounted? (Y/N) 


After you type YES, you receive this message: 


$MOUNT-I-MOUNTED, CONSOLE mounted on _CSAI: 
Enter name of default boot command file: 


Enter the appropriate name in the form dduBOO.CMD. Note that 
you must not do an interactive boot. The upgrade kit is set 
with parameters that boot any system. 


The following is then displayed: 
Default boot command file replaced with dduBOO.CMD 


Are you satisfied with this file as the default boot 
command file? (Y/N) 


If you are satisfied with this file as the default boot 
command file, proceed. If you are not satisfied, return to 
step l. 


Put your old console TU58 into drive CS1l. Answer YES when 
you receive the following message: 


Is the old console TU58, CS1:, ready to 
be mounted? (Y/N) 


UD. 


ll. 
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The system will respond: 
tMOUNT-I-MOUNTED, mounted on CSAIL: 
The TU58 is copied to the system disk for editing. 


Now, put a scratch console TU58 into the console drive. (The 
blank TU58 provided with your distribution kit may be used.) 
The upgrade procedure now checks the new console TU58 for any 
defective blocks by running the Bad Block Locator Utility. 
The new console TU58 will be written just before the system 
is rebooted in order to boot from the V3.0 kernel system. Do 
not put your normal console media back in the console drive 
during the remainder of the upgrade procedure. 


The upgrade procedure now asks: 

Is a scratch console TUS58 now in CS1:? (Y/N): 
Answer YES. 
The system responds: 

SMOUNT-I-MOUNTED, mounted on CSAI: 


The upgrade procedure now removes all VAX/VMS V2.5 files not 
needed to complete the upgrade, and causes the V3.0 required 
save set to be copied to the system disk. BACKUP then starts 
a verification pass to make sure ali the files in the save 
set have been correctly copied. 


When the verification pass is complete, the upgrade procedure 
purges th paging, swapping, dump, and authorization files 
back to one version. (Ignore any file not found messages.) 


If you are booting from the TU58, the upgrade procedure now 
initializes the new console TU58, copies unmodified files to 
the new console TU58, and sets the DEFBOO.CMD command 
procedure to boot V3.0 from the directory [SYSF.SYSEXE]. 
(More information on top-level system directories can be 
found in the VAX/VMS Release Notes.) 


When the upgrade procedure reaches this point, you receive 
the following message: 


System shutting down to boot a kernel V3 system. 


If you are booting from the TU58, leave the newly created 
site-specific console TU58 in the console drive for the 
remainder of the upgrade procedure. 


Leave the distribution kit and the system disk where they are 
for the remainder of the upgrade procedure. 


The SYSGEN parameters are set to boot any system. Do not 
change them during the reboot, or the upgrade may fail to 
execute properly. 


The system shuts down as part of the upgrade procedure. Tf 
you are booting from the TU58, you will have to type B after 
each reboot when the BOOT58> prompt is displayed. 
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If rebooting from the disk, after the system shutdown 
completes, type: 


CTRESP 
B/FOOO0000 ddcu: 


From this point on, all reboots from the disk will execute 
without user intervention. 


At this point, a kernel V3.0 system is booted and announces: 
VAX/VMS Version V3.0 <date hh:mm> 
$ SET NOVER 


Continuing with VAX/VMS V3.0 Upgrade Procedure. 


G.3.2 Upgrade Phase 2 


At the beginning of the second phase of upgrade you receive this 
message: 


%OPCOM, <date hh:mm>, logfile initialized by operator 
OPAO logfile is SYSSMANAGER: OPERATOR. LOG 
%$MOUNT-I-MOUNTED, VMS300 mounted on <ddcu> 


The upgrade procedure then starts a directory cleanup. This takes a 
varying amount of time depending on the number of files on the disk. 


When the directory cleanup is complete, the upgrade procedure begins 
removing the remainder of the VAX/VMS V2.5 files. 


Next, the library save set is merged into the kernel V3.0 system. 
When this is done, BACKUP starts a verification pass. 


Then the optional save set is merged into the kernel V3.0 system. 
When this is done, BACKUP starts a verification pass. 


When the verification pass is complete, the user authorization 
accounts are modified to handle V3.0 changes. This includes providing 
each account with an ENQLM quota of at least 20 and changing default 
directories of SYSSSYSDISK and null default devices. 


At this point, the distribution kit may be removed. 


G.3.3 Upgrade Phase 3 


The third phase of the upgrade merges the VAX/VMS-distributed files 
that are commonly edited by system managers with new VAX/VMS files. 
Ignore any undefined symbol and file not found messages that appear at 
this time. 


Next, the upgrade procedure merges all the miscellaneous user files 
that exist in the old system directories into a new set of system 
directories, temporarily called [SYSF.SYSEXE], [SYSF.SYSMGR], and_ so 
on. This takes a varying amount of time, depending upon the number of 
user files. 
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G.3.4 Upgrade Phase 4 
If you are booting from TU58, you receive the following message: 


Now the new site-specific TU58 must be modified 

to allow reboot of the complete VAX/VMS V3 system. 
The new site-specific console TU58 should already 
be in CSl:. 


The new site-specific TU58 created in Phase 1 should still be in the 
console TU58 drive. 


SOS is now eStabiished as the default editor, if you previously 
requested it. 


You then receive the following message: 

System shutting down to boot the complete V3.0 system. 
If you are booting from TU58, leave the newly created site-specific 
console TU58 in the console drive. The system disk must remain where 
it is in order to proceed to the next phase of the upgrade. 
The system automatically reboots after the shutdown. 


Then the following appears: 


VAX/VMS Version V3.0 <date hh:mm> 


G.3.5 Upgrade Phase 5 


This part of the upgrade procedure creates a new site-specific SYSGEN 
parameter file, AUTOGEN. PAR. 


After a directory cleanup, and the announcement that the upgrade _ to 
VAX/VMS Version 3.0 is complete, several messages will appear. 


The upgrade has automatically created a new parameter file called 
AUTOGEN.PAR that combines the default values for V3.0 and the site- 
specific values you were using under V2.0. When the system reboots, 
it will be using the values contained in the AUTOGEN.PAR file. 


If you asked to boot from TU58, the upgrade procedure has also created 
a new site-specific console TU58. This TU58 should be used instead of 
your old one. 


The upgrade is complete after the reboot. 


G.4 THE AUTOGEN.PAR PARAMETER FILE 


AUTOGEN. PAR contains some SYSGEN parameter values identical to those 
used under V2.0. These are usually set by each site to values 
specific to that site. An example is REALTIME SPTS, 


Other SYSGEN parameter values have been set to the maximum of your 
V2.0 site-specific value and the V3.0 default value. An example is 
INSTKPAGES, 


The remainder of the SYSGEN parameters have been handled individually 
or set to the default values for V3.0. To See which category a 
particular parameter falls in, refer to the SAVPARAMS section in 
SYS SUPDATE: AUTOGEN. COM. 
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See Section 3.4 for additional information on modifying system 
parameters. 


G.5 SPECIAL FILE HANDLING DURING UPGRADE 


After you have completed the upgrade, you may wish to remove files you 
no longer need. In order to do so, you need to know that certain 
VAX/VMS-distributed files are handled specially during the upgrade. 
These include files that may have been edited by users, and shareable 
images that may have been linked into user images. 


For the following files, the V3.0 distribution kit copy of the file is 
made an older version, and any existing V2.0 copies become more recent 
versions of the file: 


[SYSMGR]FORMSTYPE. DAT 
[SYSMGR]CHARTYPE. DAT 


For the next list of files, the V3.0 distribution kit copy of the file 
is made the latest version, and any existing V2.0 copies become older 
versions of the file: 


[SYSLIB]LBRSHR. EXE 
[SYSLIB]RSXUSR. EXE 
[SYSLIB]SUMSHR. EXE 
[SYSLIB]VMSRTL. EXE 
[SYSMGR]STARTNET. COM 
[SYSEXE]STARTUP. COM 
[SYSEXE]SHUTDOWN. COM 
[SYSEXE]STARTUP.MIN 
[SYSHLPIHELPLIB.HLB 


The system manager may wish to reconcile the new versions with any 
local modifications to these files before deleting the older versions. 


The upgrade procedure does not copy these files to the system disk at 
all; you are left with the older versions of these files: 


[SYSMGR]SYSTARTUP,. COM 
[SYSMGR]SYSHUTDWN.COM 
([SYSEXE]SYSUAF.DAT 
{[SYSEXE]NOTICE. TXT 


The upgrade procedure may have changed the size of the following files 
to better fit a V3.0 system, so their use should be monitored to make 
sure they are satisfactory: 


[SYSEXE]SYSDUMP. DMP 
[SYSEXE] PAGEFILE.SYS 
[SYSEXE]SWAPFILE.SYS 


G.6 INSTALLED IMAGES 


As part of the upgrade, the file SYSSMANAGER:VMSIMAGES.DAT is created 
for your. site. This is a combined list of files that are installed 
for enhanced system performance. Some files in this list may already 
be in your site's SYSSMANAGER:SYSTARTUP.COM file and should be 
removed. 
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VMSINSTAL ERROR MESSAGES 


This appendix lists the error messages issued by the VMSINSTAL command 
procedure. Each message consists of an abbreviation followed by a 
text message. 


ACCOUNT, This installation creates an account named 'name'. 


Explanation: The product being installed has_ created (or 
updated) an account with the specified name. The User 
Authorization File (UAF) has been updated accordingly. 


User Action: None, this message is informational. 


ReImrer 


Explanation: VMSINSTAL checks to ensure that no user processes 
are active when an installation is begun. This check has failed, 
and VMSINSTAL lists those processes that are stiil active. 


User Action: You will be asked if you want to continue the 
installation. It is recommended that you remedy this situation 
before continuing. 


AUTOSYNC, Auto-answer file is out of sync with questions. 
AUTOFILE, question\answer 
QUESTION, question 


Explanation: You have specified the Auto-answer option, and 
VMSINSTAL is using the answers from an existing answer file. The 
question being asked by the installation procedure does not 
coincide with the next question and answer in the answer file. 


User Action: The installation procedure must have’ changed. 
Delete the existing answer file and begin the installation again. 


BADCONDEV, Please specify an existing console device. 


Explanation: You have specified a console device on which the 
distribution volumes are to be mounted, but the device specified 
is a console device. 


User Action: Specify an existing console device. 

BADDISDEV, Please specify a disk or tape device. 
Explanation: You have specified a device on which the 
distribution volumes are to be mounted, but the device is neither 


a disk nor a tape. 


User Action: Specify a disk or tape device. 
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BADLIBDEV, Please specify an explicit disk drive. 
Explanation: For Dual RLO2 installations, you have specified a 
device on which the library disk is to be mounted, but the device 
is not a disk. 


User Action: Specify a disk device. 


CTRLY, Installation cancelled via CTRL/Y. 


Explanation: You have cancelled the installation by entering a 
CTRL/Y. 
User Action: None, this message is informational. 


DECNET, Your DECnet network is up and running. 


Explanation: VMSINSTAL checks to ensure that your DECnet 
network has been shut down when an installation is begun. This 
check has failed. 


User Actions: You will be asked if you want to continue’ the 
installation. It is recommended that you remedy this situation 
before continuing. 


INTEGER, Please enter an integer value. 


Explanation: VMSINSTAL asked a question which must be answered 
with an integer number. 


User Action: Answer the question again, specifying an integer. 
INVOPTIONS, To specify options, parameter 3 must be the word OPTIONS. 


Explanation: If you are specifying VMSINSTAL options, the third 
Parameter to VMSINSTAL must be the word OPTIONS. 


User Action: Invoke VMSINSTAL again, specifying the options in 
the correct format. 


IVPFAIL, The IVP for ‘product' has failed. 


Explanation: VMSINSTAL has invoked the Installation 
Verification Procedure (IVP) for the specified product, and the 
IVP has failed. 


User Action: If you can determine the problem and resolve it, 
then simply install the product again. Otherwise, Contact your 
local DIGITAL support representative. 


LIBDIFF, The following system and library disk files do not match. 
LIBDIFF2, You must resolve these differences before continuing. 


Explanation: For Dual RLO2 systems, VMSINSTAL temporarily 
removes all nonessential system files from the system disk. 
Before doing this, however, it checks to ensure that the copies 
of these files on the system disk match those on the library 
disk. This check has failed, and the offending files are listed. 


User Action: You must resolve the differences before reinvoking 
VMSINSTAL. 
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LOWQUOTA, One or more account quotas may be too low. 


Explanation: VMSINSTAL checks to ensure that your’ process 
quotas are valid when an installation is begun. This check has 


failed. 
User Action: You will be asked if you want to continue’ the 
installation. It is recommended that you remedy this situation 


before continuing. See Section 4.2 in this guide. 
MOVEFILES, Files will now be moved to their target directories 


Explanation: If sufficient disk space is available at the 
beginning of an installation, VMSINSTAL builds new files ina 
working directory for the optional product or update. After all 
the files are built, they are moved to their target directories. 


User Action: None, this message is informational. 
NEXTVOL, The next volume will be mounted to try again. 


Explanation: VMSINSTAL is attempting to restore a product’ save 
set with the Backup utility. The required save set was not 
located on the currently mounted distribution volume, So 
VMSINSTAL will examine the next volume. 


User Action: This message will be preceded by various’ serious 
BACKUP messages, which can be ignored. You will be asked to 
mount the next distribution volume. 


NOCONSOLE, Unknown CPU type; console volume not remounted. 


Explanation: While attempting to remount the console volume, 
VMSINSTAL could not determine what type of CPU you have. 


User Action: Contact your local DIGITAL support representative. 
NOFILE, [new] file 'file'" does not exist. 


Explanation: VMSINSTAL is attempting to locate an existing (or 
perhaps new) file with the given name, but the file does not 
exist. This message should be proceeded by other messages’ that 
explain it in greater detail. 


User Action: If you can determine the problem and resolve it, 
then simply install the product again. Otherwise, contact your 
local DIGITAL support representative. 


NOLIBDISK, Library disk could not be mounted. 
Explanation: You were asked to mount the library disk so that 
an installation could be performed on a Dual RLO2 system. For 


some reason, the library disk could not be mounted. 


User Action: Correct the situation that prevented mounting the 
library disk and begin the installation again. 
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NOPRINT, File 'file' cannot be printed. 
Explanation: The product installation required the printing of 
one or more files, but the files could not be queued for 
printing. 
User Action: This error is most likely caused by the fact that 
a SYSSPRINT queue is not defined at your site. If you do not 
care that the files could not be printed, then you can _ ignore 
this message. Otherwise, define a SYSSPRINT queue and perform 
the installation again. 

NOPROC, The kit's installation procedure is missing. 


Explanation: The main installation procedure for the product 
could not be located on the distribution volumes. 


User Action: Contact your local DIGITAL support representative. 
NOPRODS, None of the specified products were found. 

Explanation: You have specified one or more products’ to. be 

installed from the distribution volumes, but none of the products 

exist on the volumes. 

User Action: Specify products which exist on the volumes. 


NOREINSTALL, Image ‘image’ could not be reinstalled. 


Explanation: VMSINSTAL was attempting to use the INSTALL 
utility to make an image known to the system. The INSTALL 
utility failed. 


User Action: This message should be preceded by a message from 
the INSTALL utility explaining the problem. Correct the problem 
and begin the installation again. 
NOSAVESET, Required saveset 'letter' does not exist. 

Explanation: The product save set with the specified letter, 
which is required for the installation, does not exist on the 
distribution volumes. 

User Action: Contact your local DIGITAL support representative. 


NOSETPRV, You are not running on an account with SETPRV privilege. 


Explanation: VMSINSTAL checks to ensure that your account has 
SETPRV privilege when an installation is begun. This check has 


failed. 
User Action: You will be asked if you want to continue the 
installation. It is recommended that you remedy this situation 


before continuing. 
NOSPACE, There are not enough blocks to restore the system disk. 


Explanation: After installation on a dual RLO2 system, 
VMSINSTAL attempts to restore your system disk to its original 
tailoring configuration. However, there are not enough free 
blocks left on the system disk. 


User Action: VMSINSTAL tells you how many additional free 
blocks are required. You must make more space on the system disk 
by purging and/or deleting files. Once this is accomplished, you 
can restore the original tailoring configuration. 
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NOTSYSTEM, You are not logged in to the SYSTEM account. 


Explanation: VMSINSTAL checks to ensSure that you are logged 


in 


to the SYSTEM account when an installation is begun. This check 


has failed. 


User Action: You will be asked if you want to continue 


the 


installation. It is recommended that you remedy this situation 


before continuing. 


PEAKUTIL, This product requires 'number' blocks during installation. 


Explanation: The installation procedure for the _ product 


has 


determined that there are not enough free blocks on the system 


disk to install the product. 


User Action: Make more space on the system disk by purging 


and/or deleting files, and then install the product again. 
PRODSKIP, Products that have not been installed will be skipped. 


Explanation: You have requested that multiple products 


be 


installed, but one of these products requires that the system be 
rebooted after its installation. In order to accomplish this, 


the remaining uninstalled products must be skipped. 


User Action: Reinstall the remaining products after the system 


is rebooted. 
REBOOT, This product requires that the system be rebooted. 


Explanation: The product that was just installed requires 
the system be rebooted to complete the installation. 


User Action: Reboot the system after shutdown completes. 
RECORDANS, Auto-answer file will be recorded. 


Explanation: The Auto-answer options was specified 


that 


when 


VMSINSTAL was’ invoked. No answer file exists for the product 


about to be installed, so one will be recorded. 


User Action: Answer the prompts and questions as’ usual. 
answers will be recorded. 


RECOVER, 'product' was being installed when the system crashed. 


Your 


Explanation: The specified product was being installed when the 


system crashed due to a power failure or other problem. 


User Action: You will receive additional instructions on how to 


proceed. 


RESTORE, Restoring product saveset ‘letter’... 


Explanation: The specified product save set is about to 
restored from the distribution volumes by the Backup utility. 


User Action: This message is purely informational. 


be 


VMSINSTAL ERROR MESSAGES 


RETAILOR, Your original tailoring environment will now be restored. 


Explanation: The tailoring files that were removed from your 
system disk for installation, will be copied back to the system 
adisk:. 

User Action: None, this message is informational. 


REWIND, The tape will be rewound to try again. 


Explanation: VMSINSTAL is attempting to restore a product save 
set with the Backup utility. The required save set was not 
located on the currently mounted distribution tape, but VMSINSTAL 
will rewind the tape in case the savesets were not recorded in 
order. 


User Action: This message will be preceded by various’ serious 
BACKUP messages, which can be ignored. 


SMALLDISK, This is a small disk system. 


Explanation: VMSINSTAL has determined that you are running a 
dual RLO2 system. It will temporarily remove all nonessential 
files from the system disk in order to make room for the 
installation. 


User Action: You will receive additional instructions as to how 
to proceed. 


STEP8FAIL, The installation of ‘product’ has failed. 
STEPOFAIL, The installation of ‘product’ has failed. 


Explanation: The installation of the product has failed due to 
some unrecoverable error. 


User Action: Additional messages should precede this one. 
These messages will explain the problem in greater detail. If 
you can remedy the situation, then simply install the product 


again. Otherwise, contact your local DIGITAL Support 
representative. 


SYSDIR, This product creates system directory ‘directory’. 


Explanation: The product being installed creates the specified 
system directory. 


User Action: This message is purely informational. 
SYSDISK, This product creates system disk directory ‘directory’. 


Explanation: The product being installed creates a directory on 
the system disk. 


User Action: This message is purely informational. 


VMSINSTAL ERROR MESSAGES 


TAMPER, File 'file' has been tampered with. 
Explanation: VMSINSTAL is attempting to update a system text 
file, but the file has been modified locally. The update cannot 
be performed. 


User Action: If you modify system text files, then they cannot 
be updated by DIGITAL software installations. 


UNEXPECTED, Installation terminated due to unexpected event. 
Explanation: Some unexpected event has caused the immediate 
termination of VMSINSTAL. This message should be preceded by 
other messages that explain the problem in greater detail. 

User Action: If you can determine the problem and resolve it, 
then simply install the product again. Otherwise, contact your 
local DIGITAL support representative. 

UPDATED, File 'file' is already updated. 


Explanation: VMSINSTAL is attempting to update a system text 
file, but the file has already been updated successfully. 


User Action: This message is purely informational. 


USEANS, Auto-answer file will be used. 


Explanation: The Autc-answer options was pecified when 
VMSINSTAL was invoked. An answer file exists oo the product 


about to be installed, so the recorded answers will be used. 


User Action: You will not have to answer prompts and questions 
displayed by the product. If you want to record new answers, 
then you must delete the answer file and install the product with 
the Auto-answer option. 


VMIORIG, VMIORIG.TLR still exists; please see your documentation. 


Explanation: When performing an installation on a Dual _  RLO2 
system, VMSINSTAL records the current tailoring configuration and 
then removes it from the system disk temporarily. The 
configuration is recorded in the file SYSSUPDATE:VMIORIG.TLR. 
After installation, VMSINSTAL restores the configuration and 
deletes VMIORIG.TLR. If, however, the system crashes during the 
installation, then you must restore the configuration and delete 
the file manually. 


User Action: Because VMIORIG.TLR still exists, VMSINSTAL 
assumes that you have not restored your tailoring configuration. 
You must do so, and then delete VMIORIG.TLR. 

YESNO, Please enter YES or NO, 


Explanation: VMSINSTAL asked a question which must be answered 
with YES or NO. 


User Action: Answer the question again, specifying YES or NO. 
You may abbreviate these as Y or N. 


AUTOGEN.PAR parameter file, 
G-7 


Backup Utility (BACKUP), 
save set, 2-1 

BOOTS5S8 program, 1-1 

Bootstrap, 
conversational, 5-3 
initial ,RLO2/RA80, 2-9 
nonstop, 5-3 

Building a bootable system 

disk, 2-1 


Command procedures, 
CONSCOPY.COM, 5-1 
STABACKIT.COM, 5-9 
VMSINSTAL.COM, 2-10 
VMSKITBLD.COM, 5-6 

CONSCOPY.COM command 

procedure, 5-1 

Console subsystem, 1-1 


Device name specification, 
Distribution kit, 
See VAX-11/750 software 
distribution kit 


EDTCAI, 2-3 


Log in, 
system manager, 2-10 


Maintenance update, 
See System update 


INDEX 


2-4 


Index-1 


Optional kit restoration, 
RLO2/RA80, 2-10 
Overview, 
of building a bootable 
system disk, 2-1 
of system installation, 1-5 


Software distribution kit, 
See VAX-11/750 software 
distribution kit 
STABACKIT.COM command 
procedure, 5-9 
Stand-alone BACKUP, 
building a kit, 5-9 
loading, 2-6 
SYSBOOT program, 5-4 
commands, 5-4 
System update, 4-1 
distribution kit, 4-1 
System upgrade, G-l 
preparation, G-2 
restart, G-l 


VAX-11/750 console subsystem, 
1-1 
VAX-11/750 software 
distribution kit, 2-1 
magnetic tape kit, 2-2 
optional, 2-3 to 2-4 
primary, 2-3 
RA60 kit, 2-3 
RKO7 kit, 2-3 
VMSINSTAL command procedure, 
4-1 
VMSINSTAL option, 4-4 
VMSINSTAL product list, 4-3 
VMSINSTAL.COM command 
procedure, 2-10 
VMSKITBLD.COM command 
procedure, 5-6 
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PCS 758 INSTALLATION PROCEDURE 


INSTALLATION PROCEDURE 


To install the PCS (Patchable Control Store) boarg, follow the 
procedure below: 


1. Remove the L@085 from slot 5. 
2. Install the L@@88 in slot 5. 


a. If you are removing the L9@85 without the WCS daughter 
board, install an LOSG8-YA. 


b. If you are removing the L@@85 with the WCS daughter 
board, install an LO@BGB8-YB. 


DIAGNOSTICS 


1. Power up the system. 


wet I a loc as 


2. Boot the Diagnostic Supervisor to automatically ioad_ the 
PCS for testing. 


NOTE 
The minimum revision level of the 
Diagnostic Supervisor (ECSAA) that will 
load the PCS with microcode is 6.16B. 


UPDATING VMS (TO LOAD THE PCS) 
re Boot VMS. 
NOTE 
Booting VMS will not load the PCS 
unless SYSTARTUP.COM has been updated 
to do so. 
2. Log in under the system manager account. 
3. Set the default to [SYSUPD]. 
4. Insert the PCS75@KIT TU58 cassette (BE-T538A-BE) in CSAl. 


5. Type @VMSUPDATE. ~DE & 


NOTE 
You will be asked some questions, the 
first one being “Are you ready?” This 
is just to see if the TU58 is loaded. 
Answering "yes" will mount the TUS58. 
From this point on, the command file on, 
the TU58 will be run. 


6. Answer the two questions asked by the update command file 
program, 


ae 


Question 1: 


If you have battery backup, do you want powerfail 
recovery? 


NOTE 
Powerfail recovery does not work at 
this time with all VMS Version 2 
systems. 


The answer to this question determines how a power 
failure is to be handled. If you have a power failure 
and you have battery backup, the PCS 
reloaded unless the PCS device driver is included 
along with the proper command file that defines that 


dGevice driver. 


7717 nnAt be 
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Answering "yes" to this question means the device 
Griver (PCS75@8DRV) will be included with the PCS 
loader utility (PCS75QUTL). Also, the command file 
PCS75@RES.COM will be added to the system manager 
account ([SYSMGR]) and SYSTARTUP.COM will be appended 
to call that command file. If a power failure occurs 
with battery backup, the driver will be awakened by 
the system to reload the PCS. 


If you answer "no" to this question, the driver will 
not be included with the utility and the command file 
PCS75@.COM will be added to [SYSMGR] with a call to 
that command file from SYSTARTUP.COM. 


Question 2: 
Do you want SYSTARTUP.COM updated to load PCS? 
oun ‘ ' 
This question is whether to append PCS75@.COM or 


PCS75@RES.COM to SYSTARTUP.COM (depending on = your 
answer to Question 1). 


Answer "yes" to this question if this is the first 
time you are running the update command to install PCS 
loaders. 


Answer "no" to this question if you are just updating 
the binary file or software, if you already have a 
call to the command files in SYSTARTUP,COM, or if you 
plan to use a different command file to load the PCS. 


VMS UPDATE CHECKS 


After the above two questions have been answered, the update 
command file will put the files in the proper locations and modify 
SYSTARTUP.COM to load the PCS upon power-up or restart. When the 
update command file is complete, do the following checks: 


1. All files named PCS*.* are deleted out of [SYSUPD]. 

2. The following are in fsysipp]: 7 } 

PCS758.BIN [svSExé) : (S15 4sysTEM) 
Ds PCS75Q0UTL.EXE 


c. PCS75GDRV.EXE . 
(only if you answered "yes" to Question 1). VO 


3. If you answered "yes" to Question 1: A/O 
a. Check that PCS75@RES.COM is in [SYSMGR]. 


b. Check that SYSTARTUP.COM has $ @PCS75@RES 
(as the last command). 


wt " 


4. If you answered "no" to Question 1: 
a. Check that PCS758.COM is in [SYSMGR]. 


b. Check that SYSTARTUP.COM has $ @PCS758 
(as the last command). : 


5. Edit SYSTARTUP.COM so that either @PCS756 or @PCS756RES is 
near the beginning. 


6. Check that there is only one call to load the PCS _ from 
SYSTARTUP.COM. 


7. Reboot the system to load patches. 


Ucernmamet SYSTEM 

Fascuard? 
Welcome to VAX/YMS version V3.2 

¢ @UNSUPDATE , 

“DCL-E-OFENIN: error orening SYS$SYSROOT:CSYSMGRIVMSL. »COM? 35 input 

“RMS=-E-FNF, flle not found — } 

6 SET DEF cSysupny' '' 

$ @ASUPNATE ? 


® ol UMS Urdate Frocedure 


‘This command procedure Pperforms VAX/VHS software urdates ond 
urttonel software installations for VAX/Y¥M5 Release 3. 
Nuring this sequences the stundard console medium will mot 
be Present in the console drive. Therefores the system may 
he yulnerable fo a rower failure or other fatal crash, If a 
“custem oepash should occur’ during this reriod the urdate 
sequence can te restarted et the bedinning of the first 
incomelete urdetes 


, 


Nismount the current console moclium, 
. t 4 . 


Ples.e ploce the farst volume in the console drive 


hie #ou resd: to continue??? YES 
YAOUNT=Tee oust oy PCOZOOKIT mounted on ~CSA1! 


ir yuu fase betters backup, do youcwant rpowerfoil recoveryu?t NO 

wd ‘ ‘ 
Po vou sat SYSTAPTUR. COM urdated to lbad PCS?t YES 
YCORV<S-CUFIED: COAL{CSTSUPDIFCS750.BING12 coried to SYS$SYSROOT:CSYSUFDIFCS750,BING12 (22 blocks) 
“CORYT-S-COFTENs CSNLICS CSUPHIPCS75OUTL,ORIF2 coried to SYS$SYSROOTSCSYSUFDIPCS750UTL OBJ? (6 blocks) 
~COPY-S-CORIENs COMLILSYSUPDIPCS75SONSG OHUFS coried to SYS$SYSROOTICSYSUFDIFCS750NSG.OBJ#3 (3 blocks) 
ZCURY-S-COFTELs CSALIOSYSUPUIFCS750,COMs1 coried to SYS$SYSKOOTICSYSUFDIFCS750.CON$1 (1 block) 
ZCORY-S-CUFIE Ds Conti PSYSUPNIPCSSYS,COMF! coried to SYS$SYSROOT{CSYSUFDIFCSSYS.COM#1 (1 block) 
$¢ LIVE FCT PSOCUTLO FC. 7UOMSG/EXE=CSYSEXEIFCS7ZSOUTL/NOTRACE RACH 
PSET fork iF gr 
“HELETE-I-DELE TED, SYTS+SVERDOTILSYSUPDIFCS7SQUTL OBJI2 deleted 
"“HELETE-IT-DELETENs GfSbSYSRUOTS I SYSUPDIFCS750M5G,.0RJ53 deleted 
=COPY-S-COFI£ ie CYSHSYSRGOTSLSYSUFLIFCS750. BINj12 coried to SYS¢SYSROOTSCSYSEXEIPCS750.BING12 (22 blocks) 
“DELETE-I-ELELETED, LYSHSYSKROOTICSYSUPDIFCS750.BIN¢12 deleted 
SCOR (Se. Rigs Sto lSYSROOTICSYSUFDIFCS750.,COM#1 coried to SYS$SYSROOTICSYSHGRIFCS750.COM#1 (1 block) 
“AV ECND-P-cfERTENs SYS#$SYSRUOTECSYSUFDISYSTARTUF,COM#1 crested 
TAPE Leb ese teb ibe SYStSTSROOTIESYSMGRISYSTAKTUP,. COMFL copied to SYS$SYSROOTICSYSUFDISYSTARTUP,COM#1 (0 records) 
“OPPENDAS- ARE EWUED SYStS(SROOTICSYSUPDIPCSSYS COMS1 arrended to SYS#SYSKOOTSCSYSUPDISYSTARTUP.COM#1 (3 records) 
YCOPY-S-CGELEL, S1SéSYSKOOTICSYSUPNISYSTARTUP.COMs1 coried to SYSSSYSROOT{ CSYSMGRISYSTARTUP,.COM82 (1 block) 
YUELCTE-T-IT CL £L1TCts SYSS$SYSROOTICSYSUPDISYSTARTUP,COM§1 deleted 
“HEL ETE -1-DELETEDs SYS#*S7SROOTIOSYSUPLIFCS750.,COMs1 deleted 
“ERLETEL -~2 UELETEDs SYS4SYSRUOTILSYSUPDIFCSSYS.COMs1 deleted 


NOTE! StSshArnGERSSYSTARTUP.COM has been modified to 
Joe microcode ratches without battery buckur 
rower fail recover ‘ 

tg OC CTPANGGER I OYSTARTUP. CUM Should be edited so 
Co bbe the wali tocthe ‘commans file to load PCS 
% "PEC ETT. d MEE SZOORESY Js oear the beginning, 


Unoeb tu te gure there isconlw one call to loud FCS 


‘a { 


x 
REBOOT FHR SYSTEM’ TO LAAN MTICROCOLE PATCHES 
be . ' | 


SYSthAnAGEFE of CYSESYSTEM: have hot been Purged 
' e ; . ' 1 


' SN Ei a ian 


mee there more bite to process??? NO 


Flesiw rece lie custom console medium in the console drives 

. ode : : * 

Abe vou reede tu combine?) YES of 

“MOUNT-T+MOUNTEIty CONSOLE mounted on .CSAL1 

Reauegted wrdabe ceauence is complete, 

* DIF FCS*,* 
Na? Piles found, 

+ SH PER is ee oe 
LYSSSYSPO00TICSYSUFLY a 
CET DEF SYS#LOGIN 


2 onTr mmrw 
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READER’S COMMENTS 


NOTE: This form is for document comments only. DIGITAL will use comments submitted on this form at the 
company’s discretion. If you require a written reply and are eligible to receive one under Software 
Performance Report (SPR) service, submit your comments on an SPR form. 


Did you find this manual understandable, usable, and well organized? Please make suggestions for improvement. 


Did you find errors in this manual? If so, specify the error and the page number. 


Please indicate the type of user/reader that you most nearly represent. 


(] Assembly language programmer 
[] Higher-level language programmer 
(] Occasional programmer (experienced) 
[] User with little programming experience 
(_} Student. programmer 
(_] Other (please specify) 
INV NG 5 ee es Date 
Organization 
Street 
City. 3 = a th a Sate, — ~__- Jip Code 


or Country 


— — — DoNot Tear - Fold Here and Tape — — — — — sty ® pase oe. te 


No Postage 


Necessary 
if Mailed in the | | 
United States 





BUSINESS REPLY MAIL 


FIRST CLASS PERMIT NO.33 MAYNARD MASS. 





POSTAGE WILL BE PAID BY ADDRESSEE 


BSSG PUBLICATIONS ZK1-3/J35 
DIGITAL EQUIPMENT CORPORATION 
110 SPIT BROOK ROAD 

NASHUA, NEW HAMPSHIRE 03061 


== -—= = DoNot Tear- Fold Here. SSS SS SSS SS SS SS OS SS | 


Cut Along Dotted Line 


